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Advance Praise for Head First iPhone Development 

“The great thing about this book is its simple, step-by-step approach. It doesn’t try to teach everything — it 
just launches you right into building iPhone applications in a friendly, conversational way. It’s a fantastic 
book for people who already know how to write code and just want to get straight into the meat of 
building iPhone applications. 5, 

— Eric Shephard, owner of Syndicomm 


“Head First iPhone Development was clearly crafted to get you easily creating, using and learning iPhone 
technologies without needing a lot of background with Macintosh development tools.” 

— Joe Heck, Seattle Xcoders founder 


“This book is infuriating! Some of us had to suffer and learn iPhone development ‘the hard way，’ and 
we’re bitter that the jig is up.” 

— Mike Morrison, Stalefish Labs founder 


“Head First iPhone Development continues the growing tradition of taking complex technical subjects and 
increasing their accessibility without reducing the depth and scope of the content. iPhone Development 
is a steep learning curve to climb by any measure, but with Head First iPhone Development, that curve is 
accompanied with pre-rigged ropes, a harness, and an experienced guide! I recommend this book for 
anyone who needs to rapidly improve their understanding of developing for this challenging and exciting 
platform.” 


— Chris Pelsor, snogboggin.com 



Praise for other Head First books 


“Head First Object Oriented Analysis and Design is a refreshing look at subject of OOAD. What sets this book 
apart is its focus on learning. The authors have made the content of OOAD accessible, usable for the 
practitioner.” 

— Ivar Jacobson, Ivar Jacobson Consulting 

“I just finished reading HF OOA&D and I loved it! The thing I liked most about this book was its focus 
on why we do OOA&D-to write great software!” 

— Kyle Brown, Distinguished Engineer, IBM 

“Hidden behind the funny pictures and crazy fonts is a serious, intelligent, extremely well-crafted 
presentation of OO Analysis and Design. As I read the book, I felt like I was looking over the shoulder 
of an expert designer who was explaining to me what issues were important at each step, and why.” 

— Edward Sciore, Associate Professor, Computer Science Department, 

Boston College 

“All in all, Head First Software Development is a great resource for anyone wanting to formalise their 
programming skills in a way that constantly engages the reader on many different levels.” 

— Andy Hudson, Linux Format 

“If you’re a new software developer, Head First Software Development will get you started off on the right foot. 
And if you’re an experienced (read: long-time) developer, don’t be so quick to dismiss this...” 

— Thomas Duff ， Du£fbert ? s Random Musings 

“There’s something in Head First Java for everyone. Visual learners, kinesthetic learners, everyone can 
learn from this book. Visual aids make things easier to remember, and the book is written in a very 
accessible style — very different from most Java manuals.. .Head First Java is a valuable book. I can see the 
Head First books used in the classroom, whether in high schools or adult ed classes. And I will definitely 
be referring back to this book, and referring others to it as well.” 

— Warren Kelly ， Blogcritics.org, March 2006 



Praise for other Head First books 


“Another nice thing about Head First Java, 2nd Edition is that it whets the appetite for more. With later 
coverage of more advanced topics such as Swing and RMI，you just can’t wait to dive into those APIs 
and code that flawless, 100000-line program onjava.net that will bring you fame and venture-capital 
fortune. There’s also a great deal of material, and even some best practices, on networking and threads— 
my own weak spot. In this case, I couldn’t help but crack up a little when the authors use a 1950s 
telephone operator — yeah, you got it, that lady with a beehive hairdo that manually hooks in patch 
lines — as an analogy for TCP/IP ports... you really should go to the bookstore and thumb through Head 
First Java, 2nd Edition. Even if you already know Java, you may pick up a thing or two. And if not, just 
thumbing through the pages is a great deal of fun.” 

— Robert Eckstein ， Java.sun.com，April 2005 

“Of course it’s not the range of material that makes Head First Java stand out, it’s the style and approach. 
This book is about as far removed from a computer science textbook or technical manual as you can get. 
The use of cartoons, quizzes, fridge magnets (yep, fridge magnets ...). And, in place of the usual kind of 
reader exercises, you are asked to pretend to be the compiler and compile the code, or perhaps to piece 
some code together by filling in the blanks or ... you get the picture... The first edition of this book was 
one of our recommended titles for those new to Java and objects. This new edition doesn’t disappoint 
and rightfully steps into the shoes of its predecessor. If you are one of those people who falls asleep with 
a traditional computer book then this one is likely to keep you awake and learning.” 

— TechBookReport.com，June 2005 


“Head First Web Design is your ticket to mastering all of these complex topics, and understanding what’s 
really going on in the world of web design...If you have not been baptized by fire in using something as 
involved as Dreamweaver, then this book will be a great way to learn good web design. ’’ 


— Robert Pritchett ， MacCompanion, April 2009 Issue 


“Is it possible to learn real web design from a book format? Head First Web Design is the key to designing 
user-friendly sites, from customer requirements to hand-drawn storyboards to online sites that work 
well. What sets this apart from other 4 how to build a web site’ books is that it uses the latest research 
in cognitive science and learning to provide a visual learning experience rich in images and designed 
for how the brain works and learns best. The result is a powerful tribute to web design basics that any 
general-interest computer library will find an important key to success.” 

— Diane C. Donovan, California Bookwatch: The Computer Shelf 


“I definitely recommend Head First Web Design to all of my fellow programmers who want to get a grip on 
the more artistic side of the business. ，’ 


— Claron Twitchell, UJUG 
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getting started 

Going mobile 

The iPhone changed everything. 

It’s a gaming platform, a personal organizer, a full web browser, oh yeah, 
and a phone. The iPhone is one of the most exciting devices to come out 
in some time, and with the opening of the App Store, it’s an opportunity for 


independent developers to compete worldwide with big named software 
companies. All you need to release your own app are a couple of software 
tools, some knowledge, and enthusiasm. Apple provides the software and 
we’ll help you the knowledge; we’re sure you’ve got the enthusiasm covered. 
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2 : 


ello @twitter! 


pps have a lot of moving parts. 

OK, actually, they don’t have any real moving parts, but they do have lots of Ul 


controls. Atypical iPhone app has more going on than just a button, and now it’s time 
to build one. Working with some of the more complicated widgets means you’ll need 
to pay more attention than ever to how you design your app as well. In this chapter, 
you’ll learn how to put together a bigger application and some of the fundamental 
design patterns used in the iPhone SDK. 
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witter needs variety 

e did a lot in Chapter 2, but what language was that? 


Parts of the code you’ve been writing might look familiar, but it’s time you got a sense 
what’s really going on under the hood. The iPhone SDK comes with great tools 
that mean that you don’t need to write code for everything, but you can’t write entire 
apps without learning something about the underlying language, including properties, 
message passing, and memory management. Unless you work that out, all your 
apps will be just default widgets! And you want more than just widgets, right? 
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Renee is catching on.... 

Make room for custom input 

Header files describe the interface to your class 

Auto-generated accessors also handle memory management 

To keep your memory straight, you need to remember just two things 

But when Mike’s finished typing... 

Customize your UITextField 

Components that use the keyboard ask it to appear... 
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A table with a view 

Most iPhone apps have more than one view. 

We’ve written a cool app with one view, but anyone who’s used an iPhone knows 
that most apps aren’t like that. Some of the more impressive iPhone apps out there 
do a great job of moving through complex information by using multiple views. We’re 
going to start with navigation controllers and table views, like the kind you see in 
your Mail and Contact apps. Only we’re going to do it with a twist... 




So, how do these views fit together? 

The navigation template pulls multiple views together 
The navigation template starts with a table view 
A table is a collection of cells 
Just a few more drinks 
Plists are an easy way to save and load data 
Arrays (and more) have built-in support for plists 
Use a detail view to drill down into data 
A closer look at the detail view 
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plfsts and modal Views 

efining your app 


you have this almost-working app... 

That’s the story of every app! You get some functionality working, decide to add 
something else, need to do some refactoring, and respond to some feedback from 
the App Store. Developing an app isn’t a-lways ever a linear process, but there’s a lot to 


be learned in that process. 
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It all started with Sam... 



Use the debugger to investigate the crash 
Update your code to handle a plist of dictionaries 
The detail view needs data 
Each dictionary has all the information we need 
We have a usability problem 

Use a disclosure indicator if your cell leads to more information 
Sales were going strong... 

Use navigation controller buttons for editing 



The button should create a new view 
We need a view... but not necessarily a new view 
The view controller defines the behavior for the view 
A nib file contains the UI components and connections... 
You can subclass and extend views like any other class 
Modal views focus the user on the task at hand... 

Any view can present a modal view 
Our view doesn’t have a navigation bar 
Create the save and cancel buttons 


L 一 ㈣ 二冗士 

旧 r 二 一 




Write the save and cancel actions 
Your iPhone Toolbox 


186 

188 

191 

194 

195 
201 
203 
206 
211 

215 

216 

217 

218 
219 

224 

225 
230 

232 

233 
237 


XIV 


























table of contents 


saVing, editing, and sorting dqta 



Everyone’s an editor... 

Displaying data is nice, but adding and editing information 
is what makes an iPhone app really rock. DrinkMixer is great—it uses 
some cell customization, and works with plist dictionaries to display data. It’s a handy 
reference application, and you’ve got a good start on adding new drinks. Now, it’s time to 
give the user the ability to modify the data —— saving, editing, and sorting — to make it more 
useful for everyone. In this chapter we’ll take a look at editing patterns in iPhone apps and 


how to guide users with the nav controller. 



Sam is ready to add a Red-Headed School Girl... 

...but the keyboard is in the way 

We need to wrap our content in a scroll view 

The scroll view is the same size as the screen 
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/ Enterprise apps 

Enterprise apps mean managing more data in different 

Ways. Companies large and small are a significant market for iPhone apps. A small 
handheld device with a custom app can be huge for companies that have staff on 


the go. Most of these apps are going to manage lots of data, and iPhone 3.x has 



built in Core Data support. Working with that and another new controller, the tab bar 
controller, we’re going to build an app for justice! 








HF bounty hunting 

Choose a template to start iBountyHunter 
Drawing how iBountyHunter works... 

Build the fugitive list view 
Next up: the captured view 
After a quick meeting with Bob... 

Core Data lets you focus on your app 

Core Data needs to know what to load 
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Build your Fugitive entity 
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Add the database as a resource 

The template sets things up for a SQLite DB 

The iPhone’s application structure defines where you can read and write 
Copy the database to the correct place 



To be continued... 

Your Core Data Toolbox 


304 

308 

310 

316 

318 

327 

329 

330 

333 

334 
341 
344 

354 

355 

358 

359 
373 
375 







XVI 










table of contents 



migrating and optimising with core data 

Things are changing 

We have a great app in the works. 旧 ountyHunter successfully loads the 
data that Bob needs and lets him view the fugitives in an easy way. But what about when 
the data has to change? Bob wants some new functionality, and what does that do to 
the data model? In this chapter you’ll learn how to handle changes to your data model 
and how to take advantage of more Core Data features. 
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Proof in the real world 

The iPhone knows where it is and what it sees. As any iPhone user 
knows, the iPhone goes way beyond just managing data: it can also take pictures, figure 
out your location, and put that information together for use in your app. The beauty about 
incorporating these features is that just by tapping into the tools that iPhone gives you, 



suddenly you can import pictures, locations, and maps without much coding at all. 

For Bob, payment requires proof! 

The way to the camera... 

There’s a method for checking 
Prompt the user with action sheets 
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Add a new framework 




Just latitude and longitude won’t work for Bob 

Map Kit is new with iPhone 3.0 

A little custom setup for the map 

Annotations require a little more finesse 

Your extras Toolbox 

It’s been great having you here! 


432 

441 

451 

452 
458 
464 
466 

472 

473 

474 
479 

485 

486 



xviii 


























table of contents 


appendix b lefeVers 

The top 6 things (we didn’t cover) 

Ever feel like something’s missing? We know what 

you mean... Just when you thought you were done, there’s more. 
We couldn’t leave you without a few extra details, things we just couldn’t 
fit into the rest of the book. At least, not if you want to be able to carry 
this book around without a metallic case and castor wheels on the 
bottom. So take a peek and see what you (still) might be missing out on. 
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Get ready for the App Store 

You want to get your app in the App Store, right? so 

far, we’ve basically worked with apps in the simulator, which is fine. But 
to get things to the next level, you’ll need to install an app on an actual 
iPhone or iPod Touch before applying to get it in the App Store. And the 
only way to do that is to register with Apple as a developer. Even then, 
it’s not just a matter of clicking a button in Xcode to get an app you wrote 
on your personal device. To do that, it’s time to talk with Apple. 
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how to use this book 


Who is this book for? 


If you can answer “yes” to all of these: 


① Do you have previous development experience? 


② 


Do you want to learn, understand, remember, and 
apply important iPhone design and development 
concepts so that you can write your own iPhone apps, 
and start selling them in the App Store? 
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(3) Do you prefer stimulating dinner party conversation 
to dry, dull, academic lectures? 


this book is for you. 


Who should probably back away from this book? 

If you can answer “yes” to any of these: Che 匕 k out Head Fwsi J ava J( ov . a 
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(?) Are you completely new to software development? . ov-ic^tcd dcvdopmcht, a^d -thch 
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© Are you already developing iPhone apps and looking for 
a reference book on Objective-C? 


^3) Are you afraid to try something different? Would 
you rather have a root canal than mix stripes with 
plaid? Do you believe that a technical book can’t be 
serious if there’s a bounty hunter in it? 

this book is not for you. 
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intro 


the intro 


Wc know what you're thmkmg. 

“How can this be a serious iPhone development book?” 
“What’s with all the graphics?” 


“Can I actually learn it this way?” 

And we know what your brain h thmkmg. 







Your brain craves novelty. It’s always searching, scanning, waiting for 
something unusual. It was built that way, and it helps you stay alive. 


So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with 
the brain’s real]oh — recording things that matter. It doesn’t bother 
saving the boring things; they never make it past the “this is obviously 
not important” filter. 


How does your brain know what’s important? Suppose you’re out for a 
day hike and a tiger jumps in front of you. What happens inside your 
head and body? 


And there’s no simple way to tell your brain, “Hey brain, thank you 
very much, but no matter how dull this book is, and how little I’m 
registering on the emotional Richter scale right now, I really do want 
you to keep this stuff around.” 


Great. Only 
540 more dull, 
dry, boring pages. 


Just one problem. Your brain’s trying to do you a big favor. It’s trying 
to make sure that this obviously non-important content doesn’t clutter 
up scarce resources. Resources that are better spent storing the really 
big things. Like tigers. Like the danger of fire. Like how you should 
never again snowboard in shorts. 


Neurons fire. Emotions crank up. Chemicals surge. 


And that’s how your brain knows... 


This must be important! Don’t forget it! 

But imagine you’re at home, or in a library. It’s a safe, warm, tiger-free zone. 
You’re studying. Getting ready for an exam. Or trying to learn some 
tough technical topic your boss thinks will take a week, ten days at 
the most. 


/ Wd'Y' 办 # 
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Metacognition: thinking about thinking 


If you really want to learn, and you want to learn more quickly and more deeply, 
pay attention to how you pay attention. Think about how you think. Learn how you 
learn. 

Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. 


I wonder how I 
can trick my brain 
into remembering 
this stuff... 



The trick is to get your brain to see the new material you’re learning 
as Really Important. Crucial to your well-being. As important as a 
tiger. Otherwise, you’re in for a constant battle, with your brain doing 
its best to keep the new content from sticking. 


So just how DO you get your brain to think that 
iPhone development is a hungry tiger? 

There’s the slow, tedious way, or the faster, more effective way. 
The slow way is about sheer repetition. You obviously know that 


But we assume that if you’re holding this book, you really want to learn about 
iPhone development. And you probably don’t want to spend a lot of time. And since 
you’re going to build more apps in the future, you need to remember what you read. 
And for that, you’ve got to understand it. To get the most from this book, or any book 
or learning experience, take responsibility for your brain. Your brain on this 
content. 


you are able to learn and remember even the dullest of topics 


if you keep pounding the same thing into your brain. With enough 

repetition, your brain says, “This doesn’t feel important to him, but he keeps looking at 


the same thing over and over and over, so I suppose it must be.” 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning. 
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Here's what WE did: 

We used pictures, because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really is worth a thousand words. And when text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing the text refers to, as opposed to in a caption or buried in the 
text somewhere. 



We used redundancy, saying the same thing in different ways and with different media types, 
and multiple senses, to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content, because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor, surprise, or interest. 


We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 

We included loads of activities, because your brain is tuned to learn and remember more 
when you do things than when you read about things. And we made the exercises challenging- 
yet-do-able, because that’s what most people prefer. 



We used multiple learning styles, because might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 


BULLET POINTS 



We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of vievo, 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 

you 9 re not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We people. In stories, examples, pictures, etc., because, well, because j ⑽ Ye a person. 
And your brain pays more attention to people than it does to things. 


Fireside Chats 
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Here's what YOU caw do to bend 
your bram into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cui ihis sii^k a 

° h y° uir 


Slow down. The more you understand, 
the less you have to memorize. 

Don’t just read. Stop and think. When the 
book asks you a question, don’t just skip to the 
answer. Imagine that someone really is asking 
the question. The more deeply you force your 
brain to think, the better chance you have of 
learning and remembering. 

(g) Do the exercises. Write your own notes. 

We put them in, but if we did them for you, 
that would be like having someone else do 
your workouts for you. And don’t just look at 
the exercises. Use a pencil. There’s plenty of 
evidence that physical activity while learning 
can increase the learning. 

(3) Read the “There are No Dumb Questions” 

That means all of them. They’re not optional 
sidebars — they } re part of the core content! 

Don’t skip them. 

(4) Make this the last thing you read before 
bed. Or at least the last challenging thing. 

Part of the learning (especially the transfer to 
long-term memory) happens after you put the 
book down. Your brain needs time on its own, to 
do more processing. If you put in something new 
during that processing time, some of what you 
just learned will be lost. 

(5^ Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 


Talk about it. Out loud. 

Speaking activates a different part of the brain. 

If you’re trying to understand something, or 
increase your chance of remembering it later, say 
it out loud. Better still, try to explain it out loud 
to someone else. You’ll learn more quickly, and 
you might uncover ideas you hadn’t known were 
there when you were reading about it. 

(7^ Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

( 8 ) Feel something! 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 

(9^ Create something! 

Apply this to your daily work; use what you are 
learning to make decisions on your projects. Just 
do something to get some experience beyond the 
exercises and activities in this book. All you need is 
a pencil and a problem to solve... a problem that 
might benefit from using the tools and techniques 
you’re studying for the exam. 
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Read me 


This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you’ve already seen and learned. 


We start off by building an app in the very first chapter. 

Believe it or not, even if you’ve never developed for the iPhone before, you can jump right 
in and starting building apps. You’ll also learn your way around the tools used for iPhone 
development. 


We don’t worry about preparing your app to submit to the App 
Store until the end of book. 

In this book, you can get on with the business of learning how to create iPhone apps 
without stressing over the packaging and distribution of your app out of the gate. But, we 
know that’s what everyone who wants to build an iPhone app ultimately wants to do, so we 
cover that process (and all it’s glorious gotchas) in an Appendix at the end. 


We focus on what you can build and test on the simulator. 

The iPhone SDK comes with a great (and free!) tool for testing your apps on your 
computer. The simulator lets you try out your code without having to worry about getting it 
in the app store or on a real device. But, it also has its limits. There’s some cool iPhone stuff 
you just can’t test on the simulator, like the accelerometer and compass. So we don’t cover 
those kinds of things in very much detail in this book since we want to make sure you’re 
creating and testing apps quickly and easily. 


The activities are NOT optional. 

The exercises and activities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what you’ve learned. Don } t skip the exercises. Even crossword puzzles are 
important — they’ll help get concepts into your brain the way you’ll see them on the PMP 
exam. But more importantly, they’re good for giving your brain a chance to think about the 
words and terms you’ve been learning in a different context. 


The redundancy is intentional and important. 

One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books don’t 
have retention and recall as a goal, but this book is about learnings so you’ll see some of the 
same concepts come up more than once. 
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The Brain Power exercises don’t have answers. 


For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 


System requirements 

To develop for the iPhone, you need an Intel-based Mac, period. We wrote this book 
using Snow Leopard and Xcode 3.2. If you are running Leopard with an older version 
of Xcode, we tried to point out where there were places that would trip you up. For 
some of the more advanced capabilities, like the accelerometer and the camera, you’ll 
need an actual iPhone or iPod Touch and to be a registered developer. In Chapter 1, 
we point you in the direction to get the SDK and Apple documentation, so don’t worry 
about that for now. 
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The technical review team 



Technical Reviewers: 

For this book we had an amazing, elite group of tech reviewers. They did a fantastic job, and we’re really grateful for 
their incredible contribution. 

Joe Heck is a software developer, technology manager, author, and instructor who’s been involved with computing for 
25 years, and developing for the iPhone platform since the first beta release. Employed at the Walt Disney Interactive 
Media Group, Joe is involved in various technologies and development platforms, and assisted the development team 
for Disney’s iPhone game “Fairies Fly.” He’s the founder of the Seattle Xcoders developer group, which supports 
Macintosh and iPhone development in the Seattle area, and the author of SeattleBus, an iPhone app that provides real¬ 
time arrival and departure times of Seattle public transportation (available at the iPhone App Store). He also knows 
a ton about iPhones, and made sure that we were technically solid in every facet of the book. His attention to detail 
means that all of our nitty gritty answers are complete and correct. 

Eric Shepherd got started programming at age nine and never looked back. He’s been a technical writer, writing 
developer documentation since 1997, and is currently the developer documentation lead at Mozilla. In his spare time, 
he writes software for old Apple II computers — because his day job just isn’t geeky enough — and spends time with 
his daughter. Eric’s review feedback was hugely helpful. His input meant that any typos or bugs we left in the code 
were caught and fixed. His thorough review means that no one else has to go through the problems he had in actually 
making the code work. 

Michael Morrison is a writer, developer, and author of Head First JavaScript, Head First PHP & MySQL, and even a 
few books that don’t have squiggly arrows, stick figures, and magnets. Michael is the founder of Stalefish Labs (www. 
stalefishlabs . com), an edutainment company specializing in games, toys, and interactive media, including a few 
iPhone apps. Michael spends a lot of time wearing helmets, be it for skateboarding, hockey, or iPhone debugging. Since 
he has iPhone Head First experience, Mike was a great combo to have helping us. Reviewing in both capacities, he was 
nice enough to always propose a solution for us when he found a layout problem, which makes those comments easier 
to take! 

All three of these guys did a tremendous amount of review at the end in a short period of time and we really appreciate 
it! Thanks so much! 
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getting started 


Going mobile ♦ 


I just don’t see what all this 
iPhone fuss is about. My phone 
works just f ine... 


—- 


The iPhone changed everything. It s a gaming platform, a personal 
organizer, a full web-browser, oh yeah, and a phone. The iPhone is one of the most 
exciting devices to come out in some time, and with the opening of the App Store, it’s an 
opportunity for independent developers to compete worldwide with big-name software 
companies. All you need to release your own app are a couple of software tools, some 
knowledge, and enthusiasm. Apple provides the software, and we’ll help you with the 
knowledge; we’re sure you’ve got the enthusiasm covered. 


this is a new chapter 







everyone wants iphone apps 


There's a lot of buzz and a lot of money tied up m 
the App Store … 
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Mobile applications aren't just 
ported desktop apps 

There are about a billion good reasons to get into the App Store, and 
now it’s time for you to jump in. To get there from here, you’ll learn 
about designing and implementing an iPhone app, but it’s not the 
same as developing for the desktop, or writing a web application. 

It’s important to think an iPhone application through from the 
beginning. You need to constantly ask yourself “What is it the user is 
trying to do?” Get rid of everything else, minimize the input they have 
to provide, and keep it focused. 



This is NOT 

W\t same 

as 七 Wis 







Check the factors that you need to consider when you’re working on a mobile app, in general. 


Memory 
App speed 


Usage fees □ Display capabilities 

Internet access ~ User input tools (keyboard, 

mouse, display, etc.) 


Which of these factors are different for the iPhone? 
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iPhone apps arc not small desktop apps 

There’s a lot of talk about how the iPhone is a small computer that people 
carry with them. That’s definitely true, but it doesn’t mean iPhone apps are just 
small desktop apps. Some of the most important issues that you’ll encounter 
designing an app for the iPhone: 




iPhones have a small screen and are task-focused 

Even with the iPhone’s fantastic screen, it’s still relatively small (320x480). You need to put 
real thought into every screen and keep it focused on the specific task the user is doing. 




iPhones have limited CPU and memory 

On top of that, there’s no virtual memory and every bit of GPU oomph you use means more 
battery drain. iPhone OS monitors the system closely and if you go crazy with memory 
usage, it’ll just kill your app. And no one wants that. 



Only one application can run at a time 

If it’s your application running, why should you care? Because if anything else happens, like 
the phone rings, a text message comes in, the user clicks on a link, etc., your app gets shut 
down and the user moves on to another application. You need to be able to gracefully exit at 
any time and be able to put users back into a reasonable spot when they return. 
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Awatomy of aw iPhowc app 

Before we dive into creating our first app, let’s take a look at what makes up a typical 
iPhone app. 


First we have owe or wore views... 

iPhone apps are made up of one or more views — in a 
normal app, these views have GUI components on them like 
text fields, buttons, labels, etc. Games have views too, but 
typically don’t use the normal GUI components. Games 
generally require their own custom interfaces that are created 
with things like OpenGL or Quartz. 





or sowc 

a? 〆 a 一 . 


.then the code that makes the views work 


iPhone apps have a clean separation between the GUI (the 
view) and the actual code that provides the application logic. 
In general, each view has a View Controller behind it that 
reacts to button presses, table row selection, tilting the phone, 
etc. This code is almost always written in Objective-G using 
Apple’s IDE (integrated development environment), Xcode. 



由 ou staged. 


...and any other resources, all packaged into 
your application. 

If you’re new to developing for OS X you might be surprised 
to find out that applications (iPhone and full desktop apps) 
are really just directories. Any app directory contains 
the actual binary executable, some metadata about the 
application (the author, the icon filename, code signatures, 
etc.) and any other application resources like images, 
application data, help files, etc. iPhone applications behave 
the same way, so when you tell Xcode about other resources 
your application needs, it will bundle them up for you when 
you build the application. 



asso6»atca 
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Now let’s get starteef on your first iPkone App. 


參參 
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help mike make up his mind 


Mike caw't make a decision 


Mike’s a great guy, but he never knows what he wants to 
do. Help him save time waffling about what to do, and 
give him a straightforward answer. 



The way I see it is I already made the decision 
to buy an iPhone... I shouldn’t have to think again! 


O 


We’ll write Mike an app. 



Mike has an iPhone, so let’s write him an 
app that requires a simple button push 
to tell him what to do when he needs to 
make a decision. 


6 Chapter 1 




getting started 


Make a good first impression 


When users start up your application, the first thing they see is your view. It 
needs to be usable and focused on what your application is supposed to do. 
Throughout this book, whenever we start a new application, we’re going to 
take a little time to sketch up what we want it to look like. 

Our first application is pretty straightforward: it is going to be a single view 
with a button that Mike can press to get a decision. To keep things simple, 
we’ll change the label of the button to show what he should do after he 
pushes it. 
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download the SDK 


It all starts with the iPhowc SPK 

It’s time to go get some tools. Head over to http:/ / developer.apple.com/iphone. 
You can download the SDK (and other useful Apple development resources) for 
free with the basic registration, but to distribute a completed app on the App 
Store or install your app on the iPhone for testing you need to become a paid 
Standard or Enterprise Developer. The SDK comes with a simulator for testing 
directly on your Mac, so free registration is all you’ll need for now. 

The SDK comes with Xcode, Instruments, Interface Builder, and the iPhone 
Simulator. Code for the iPhone is written in Xcode using Objective-G. Interface 
Builder is used for graphically editing GUIs, Instruments helps you assess memory 
usage and performance for your app, and the Simulator is used for testing. 


Register as a developer at 
http:/ / developer, apple, 
com/iphone. 


Download the latest SDK; 
this book is based on the 
3.1 SDK. Just look for the 
Download button at the 
top of the page. 



Install the SDK. Once 
the Installation completes, 
you can find Xcode . 
app in /Developer/ 
Applications. Just 
double-click it to start it 
up. 
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tJiereiare no ^ 

Dumb Questi9ns 


What are the most important things 
to consider when developing a mobile 
app? 

There are two key things to keep in 
mind when developing a mobile application. 
First, the device has limited resources: 
memory, CPU, storage, Net access speed (if 
they have access at all), etc. Second, usage 
patterns are different for mobile applications. 
Mobile apps are generally convenience 
applications—users want to fire up your 
application, quickly accomplish their goal, 
and go back to what they were doing in the 
real world. 

I’ve developed for mobile platforms 
before, and it was a mess. Nothing 
worked the same between different 
devices, you couldn’t count on the screen 
size, they didn’t even have the same 
number of buttons on different devices! 

Is this any better? 

YES! For the most part, developing for 
iPhone avoids these problems. iPhones all 
have a 320x480 screen, an accelerometer, a 
single home key, etc. However... 

There are several different models 
of the iPhone out there. Are they all the 
same? What about the iPod Touch? 

Not all iPhone and iPod Touch devices 
are the same. For example, not all devices 
have a camera or GPS. Net access speeds 
vary by device as well depending on whether 


they’re connected to EDGE, 3G, or Wifi. To 
make matters more complicated, the iPhone 
3GS has a faster processor and better video 
card than previous iPhone models. If you 
take advantage of any features that might 
not be present on all devices you must make 
sure your code can handle not having that 
feature available. Apple will test for this 
(for example, trying to use the camera on a 
first generation iPod Touch) and reject your 
application if it doesn't accomodate a device 
properly. 

What language does the iPhone use? 

iPhone apps are generally written in 
Objective-C, an object-oriented language 
that is also used for Mac development. 
However, you can use C and even C++ 
on the iPhone. Since the GUI and Core 
Framework libraries for the iPhone are 
written in Objective-C, most developers use 
Objective-C for their application; however, 
it’s not uncommon to see support libraries 
written in C. 

Do I have to use an IDE? Tm really 
a command-line kinda developer. 

Technically speaking, no, you don’t 
have to use the Xcode IDE for straight 
development. However, the IDE makes 
iPhone development so much easier that 
you really should ask yourself if you have 
a good reason for avoiding it, especially 
since to deploy onto an actual iPhone or the 
simulator for testing, it’s mandatory. This 
book uses the Xcode IDE as well as other 


Apple development tools like Interface 
Builder, and we encourage you to at least try 
them out before you abandon them. 

Can I give applications I write out 
to friends? 

Yes and no. First, if you want to put 
an application on anyone’s actual device 
(including your own) you'll need to become 
a registered Apple iPhone Developer. Once 
you've done that, you can register a device 
and install your application on it. However, 
that’s not really a great way to get your 
application out there, and Apple limits how 
many devices you can register this way. It’s 
great for testing your application, but not 
how you want to go about passing it around. 

A better way is to submit your application 
to the iTunes App Store. You can choose 
to distribute your application for free or 
charge for it, but by distributing it through the 
iTunes App Store, you make your application 
available to the world (and maybe make 
some money, too!). We’ll talk more about 
distributing apps later in the book. 

Can I develop an app for the 
iPhone then rebuild it for other phones 
like Windows Mobile, Android, or 
Blackberries? 

In a word, no. When you develop for 
iPhone, you use Apple's iPhone frameworks, 
like Cocoa Touch, as well as Objective-C. 
Neither of these are available on other 
devices. 


Now let’s get startect. 
Launck Xcode … 


you are here ► 
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get started with templates 


Xcode includes app templates 
to help you get started 


When you start Xcode, you’ll get a welcome screen 
where you can select Create a New Project. You’ll 
get this dialog: 
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As we go through the book, we’ll use different types of projects and discuss why you’d 
choose one over another for each app. For iDecide, we have one screen (or view) that 
we’re not going to be flipping or anything, so start with the View-based Application 
and name it iDecide. 


Tke Xcode template incluctes 
more tkan just source code. 
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it all happens in xcode 


Xcode is the hub of your iPhowc project... 

When Xcode opens with your new View-based project, it will be populated with all of the 
files that you see below. We’ll be using some of the other tools that came with the SDK 
(especially Interface Builder and the Simulator), but they are all working with the files that 
are included here. 

The files and frameworks shown were stubbed out based on our selection of a View-based 
application. As we go forward, we’ll use different types of apps and that will lead to different 
defaults. 
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getting started 


■••awd plays a role m every part 
of writing your app 

Xcode is much more than just a text editor. As you’ve already seen, Xcode 
includes the templates to get you started developing an application. 
Depending on your application, you may use all of a template or just parts 
of it, but you’ll almost always start with one of them. Once you get your 
basic app template in place, you’ll use Xcode for a lot more: 


Maintaining your project resources 

Xcode will create a new directory for your project and sort the various 
files into subdirectories. You don’t have to stick with the default layout, 
but if you decide to reorganize, do it from within Xcode. Xcode also has 
built-in support for version control tools like Subversion and can be used 
to checkout and commit your project changes. 


Editing your code and resources 

You’ll use Xcode to edit your application code, and it supports a variety 
of languages beyond just Objective-G. Xcode also has a number of 
built-in editors for resource files like plists (we’ll talk more about them 
later on). For resources Xcode doesn’t handle natively, like UI definition 
(.xib) files, double-clicking on one of those files in Xcode will launch the 
appropriate editor, in this case Interface Builder. Some file types Xcode 
can only view, like pictures, or it will merely list, like sound files. 






Building and testing your application 

Xcode comes with all of the compilers necessary to build your code 
and generate a working application. Once your application is compiled, 

Xcode can install it on the iPhone Simulator or a real device. Xcode 
includes a top-notch debugger with both graphical and command-line 
interfaces to let you debug your application. You can launch profiling 
tools like Instruments to check for memory or performance issues. 

Prepare your application for sale 

Once you get your application thoroughly tested and you’re ready to 
sell it, Xcode manages your provisioning profiles and code signing 
certificates that let you put your application on real devices or upload it 
to the iTunes App Store for sale. 

OK, enougfk talking about Xcocte: ctoutle- 
click on iDecicteViewController.xit anct 
we’ll start witk tke view. 
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get to know your GUI builder 


Puild your interface using... Interface Guilder 


When you open any *.xib file in Interface Builder, it will automatically show the 
Main window, your view, and a library of UI elements. Interface Builder allows 
you to drag and drop any of the basic library elements into your view, edit them, 
and work with the connections between the code and these elements. All of these 
elements come from the Cocoa Touch framework, a custom UI framework for 
the iPhone and the iPod Touch. 
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getting started 


A GUI builder sure sounds easier. I guess it 
just spits out Objective-C code into my files? 



iDecideViewController.xib 





M 6\reaic the XML 
dcs^\rip-tioh usih^ 
l^tcv-Padc Buildcv... 


No — Interface Builder creates nibs. 

Nibs (which have .xib extensions) are XML documents that 
are loaded by the framework when the app starts up. We’ll talk 
a lot more about this in the next chapter, but for now it’s just 
important to understand that Interface Builder is not creating 
Objective-G code. It’s creating an XML description of the GUI 
you’re building, and the Cocoa Touch framework uses that to 
actually create the buttons and whatnot for your application at 
runtime. Everything we do in Interface Builder could be done in 
pure Objective-G code, but as you’ll see, there are some things 
that are really just easier to lay out with a GUI builder. 


ouv - I 








view is whd't 
the usev sees wheh 
"they v-uh ouv app. 




Views for iPkone Apps are callect 
nil>s，anct kave an .xit extension. 
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drag and drop Ul elements 


Add the button to your view 


To add elements to the view, all you need to do is drag and drop the 
elements you want onto your view. For our app, we just need a button 
with a label on it. 

o Drag the rectangular button 
onto the view. 




: What should I do?’’ by double-clicking on 
the “label’’and type the new text, then move 
the text around to center it on the button. 


Tost DriVq 


Now, save in Interface Builder and return to Xcode and click Build and Run, either 
from the Build menu or from the button in the main Xcode window. That will launch 
the Simulator. 
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getting started 


The iPhowc Simulator lets you test 
your app ow your Mac 

The Simulator is a great tool for testing your apps quickly and 
for free. It doesn’t come with all of the applications that a real 
phone does, but for the most part it behaves the same way. 
When you first start the simulator you see the Springboard, 
just like on a real iPhone, with iDecide installed (and a default 
icon that you can change later). Xcode then opens the app 
and your code is running. 

There are some differences between using the Simulator 
and your iPhone. For starters, shaking and rotating your 
Mac won’t accomplish anything. To approximate rotation 
and check landscape and portrait views, there are some 
commands under the Hardware menu. 




The Simulator has limitations. 

Memory, performance, camera, GPS, and other characteristics cannot be 
reliably tested using the Simulator. We’ll talk more about these later, but 
memory usage and performance are tough to test on the simulator simply 
because your Mac has so many more resources than the iPhone. To test 
these things, you need to install on an actual iPhone (which means joining one of the 
paid development programs). 


Well it! 


tJiereicire no o 

Dumb Questi9ns 


Are there other things that don’t 
work on the Simulator? 

The Simulator can only work with 
some gestures, network accessibility and 
core location are limited, and it doesn’t 
have an accelerometer or camera. For more 
information, reference Apple's iPhone OS 
3.0 Library documentation, via the Help 
menu in the Simulator. 

The Simulator is great for getting started with 
your application, but at some point you have 
to move over to a real device. Also, be aware 


that the iPod Touch and the iPhone are two 
different devices with different capabilities. 
You really should test on both, which means 
you'll need to join one of the paid programs. 

What’s with this whole nibs have a 
xib extension thing? 

That’s an odd artifact showing the 
roots of OS X. Nibs date back to the 
NeXTStep days, before NeXT was acquired 
by Apple. In OS X Leopard, Apple released 
a new format for nib files based on an XML 
Schema and changed the extension to xib. 
So, while the format is XML and they have 


a .xib extension, people still refer to them as 
nibs. You'll see more NeXTStep heritage in 
library class names too—almost everything 
starts with “NS”，short for NeXTStep. 

Why didn’t anything happen when I 
clicked on the button in the Simulator? 

It's temping to expect that button to 
just work out of the gate, given how much 
XCode sets up for you. However, if you think 
about what we've done, there has been 
some XML created to load a framework 
and draw a button, but we didn’t tell it to do 
anything with that button yet... 


you are here ► 
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actions happen in the code 


0K t so Interface Builder created XML, 
but we still need to write code to implement 
the button press, right? 


Ul behavior is implemented in 
Objective-C. 

Interface Builder creates your button, but to make that 
button actually do something, you’ll need to code what 
it should do. 

Controls trigger events in Objective-C when things 
happen to them, like the button being pressed or text 
changing in a text field. For events like button presses, 
Interface Builder has to connect the view controls with 
code in your controller class for action methods, tagged 
with IBAction (for Interface Builder Action). We’ll 
talk more about the Objective-C syntax later, but for 
now, you’ll need to declare a method in your header (.h) 
file and the implementation in the .m. 
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-(IBAction) 
buttonPressed : (id) 
sender; 


iDecideViewController.xib 




Button 



-(IBAction) 
buttonPressed:(id) 
sender 


method that the button 
calls 



iDecideViewController.h 



You ^vovidic 

Ale. tteves 70 U 
dodc 吖 should 

adW'7 ⑼ 』 

払 c ? 代 sscd . 


18 Chapter 1 


iDecideViewController.m 






























getting started 


^harpn your pencil 


Below is the code for when the button gets tapped. Add the bolded 
code to the iDecideViewController.h and iDecideViewController.m files. 


#import <UIKit/UIKit•h> 

Qinterface iDecideViewController : UlViewController 

IBOutlet UILabel *decisionText; 

} 


Qproperty (retain, nonatomic) UILabel *decisionText; 


- (IBAction)buttonPressed:(id)sender ; 

@end V Wic’ll *talk move about 

pv-opcv**tics U*tcv" m book. 


Well v'ced -to ^ , 
label 

ay.SY/CV, so v/c v'ccd to be 
aWc 仫 ㈣ 仫 栋 c label 
do ^ol tV.at ^amev/o 

II Wild -fvom OUV VMD. 


s 



钪⑼ 愐 WtW k ?^ssed. 



iDecideViewController.h 


#import ''iDecideViewController. h" 

@implementation iDecideViewController 

@synthesize decisionText; 



The tells dom\»lcv- 

仫 trtait 

AttUrtA m kacW We. 


- (IBAction) buttonPressed: (id) 


Se r 诎⑼如 WtW«s jessed. 


decisionText. text = @〃Go for i.t! 


u 



\A/cll use ouv ^ectr^tt b> 
-tV^c label -to *0^ 




- (void)dealloc { 

[decisionText release]; 

[super dealloc]; 


about tW»s m 


wove 



iDecideViewCon 


roller.m 
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declare your method and then implement it 


^Sharpen your pencil 

Solution 


Here’s the code from before in the context of the full files for 
iDecideViewController.h and iDecideViewController.m. 


#import <UIKit/UIKit•h> 

Qinterface iDecideViewController 
UlViewController { 

IBOutlet UILabel 
★decisionText; 


©property (retain, nonatomic) 
UILabel *decisionText; 

- (IBAction)buttonPressed:(id) 
sender; 

@end 



This Code is o-f wKa*t you II see'm a 

Kcadcr -file. Thcrc^s a dcdlara*tioh o-f 七 he 
Y\tyj IBOu'tlc't ar\d ahd a property 

-for our UILabel. 

The is wi*th happens 

*thc bu*t*toh is pressed, *tKc 
IB0u*tlc*t is a rt^trtY\Ct to the label well use 
-for ou*tpu*t -fov *the button. Well look 

a*t bo*th -these •m more detail later. 


iDecideViewController.h 


#import ''iDecideViewController. h" 

@implementation iDecideViewController 

@synthesize decisionText; 

- (IBAction)buttonPressed:(id) 


decisionText.text = @〃Go for it !〃； 



This is implcimeh*t3*tioh Codt- Wert, y/cVc 

the method «s called 'the 

bu*t*to^ is pressed； Wc use a dor\stah*t 

bo the *m -the label. Rc^criftjbcv；, 

is a \rc^c\rey\dc to -the U|Label 
y/c dv-ca*tcd \y\ |rrte\rfade Builder. 


The release Cd\\ is -for memory 
Objed-tivc-C uses vc-fc\rcr\dc douhtmj -for 

memovy (we’ll *bdlk mo\rC abou 七 

■this m a bit) a^di heeds to be released bo 
-free up *th?. ^crr>p\ry. 


iDecideViewController.m 
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getting started 



Tqst DriVQ 


Build and run the code again. Try clicking on the 
button and see if it works. 






Why didn’t the button change? Since the code 
compiled correctly ， it’s not that... 


you are here ► 
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connecting components to code 


What happened? 

The Objective-G code is all set to handle it when the button is 
pressed, but Interface Builder has no idea it needs to connect 
the button to that code. We can use Interface Builder to hook 
up our button to the buttonPressed method we just wrote. 
Then, when the .xib file is loaded by the framework, it will 
connect the button object it creates with our code. 



Unless the Ul components are hooked up to 
the code, nothing is going to happen. 


We need to connect the button’s u Hey, I just got pressed’’ 
event to our buttonPressed action method. That will get our 
method called when the user taps on the button. We then 
need to get a reference to the UILabel that the framework is 
going to create for us when the nib is loaded — that’s where 
the IBOutlet comes in. Let’s start with the outlet so we can 
change the UILabel text when the button is pressed. 
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getting started 


Use Interface Puildcr to connect Ul controls to code 

Jump back into Interface Builder for iDecideViewGontroller.xib, and let’s hook up the 
components to our new code. 


ttit bu-t-toh -to display the hiev-av-dhy 
■view; it’s a little easier io see whats 
3 om 3 ov\ With the hib. 


A 咖 
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you doh't have a two buttoh 

r ^ousc, just hit CTRL ahd thch 
didk. 

o Right-click on the label you dropped on the 
button. This will bring up a list of events and 
references. 

❺ Click on the circle next to New Referencing 
Outlet and drag it to File’s Owner (this 
represents the class file that will load this 
nib — in our case, iDecideViewG ontroller). Then 
click on the decisionText outlet. Now when 
the decisionText UILabel is generated, our 
decisionText property will be set to a reference 
to the control, thanks to the IBOutlet. 


A ^ 



Ok—I get how 
we can now change 
the label, but how 
does interface 
builder know that you 
pressed a button? 
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elements dispatch events 


Interface Guilder lists which events a component 
caw trigger 


We need to attach the right component event to the code. We wrote an action method 
earlier that we can connect the button to: 



Bwldcv- 


-( 工 BAction) byttonPressed : (id)sender; 

2 r」 s e °^ e ^ ^ win 3ei 

二 ⑽〆 



method 


W ved tV>e a6W. 


Now we need to pick the event that should trigger this method. If you right-click on 
the button in Interface Builder, you’ll see a list of events it could dispatch. We want the 
TouchUpInside event. 



TWis \'»st — 


a\\ ^ 


t 




■tV book- 


ILjlian Caffinfrlj^ni 


EkdDvdOn 
Eitainy uuuiyvlI 
kJMll>i Uti IffM 
Qltjrv Drd DiJ 

Tn\Kh fevrn fitMjl 
Tiiwh EjnAn 
liuch Urjtq lioi 
Tdruich fliaq JjiiSilfr 
Twch Dng Ounlili 
TouiliUp 
Touch _Ip Ouliki# 
VAkiw Chwgtd 
Biii-rgiftfiiig 




We II be us” 如 '4x>u 乩 
uf mside” cve^t 


Elements dispatch events whew things happen 
to them 


Whenever something happens to an element, for instance, a button gets tapped, 
the element dispatches one or more events. What we need to do is tell the button 
to notify us when that event gets raised. We’ll be using the TouchUpInside event. 
If you think about how you click a button on the iPhone, the actual click inside 
the button isn’t what matters: it’s when you remove your finger (touch up) that 
the actual tap occurs. Connecting an event to a method is just like connecting an 
element to an outlet. 
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getting started 


Connect your events to methods 

Just like with outlets, you drag the connection from the 
button event to File’s Owner and select the action that 
should be called. 




帽 nollcr. Mb 



Njmv 




Irupvtiai hiM 

t tp* 


KourvdrJ n«L tylSan 
SLibcl fWui ihouid I 



1^104 -cMMflfflj 


o Right-click on the button you dropped on the view. This 
will bring up a list of events and references like it did with 
the label. 

❺ Next click on the circle next to Touch Up Inside and 
drag it to File’s Owner. Click on the buttonPressed 
action. Now when the button gets pressed, our 
buttonPressed method will be called. 



O 


So does it really matter whether I use an 
IBOutlet or an IBAction since Interface 
Builder can use both? 



It matters a lot! 



They’re not the same. Use an IBOutlet when you need a 
reference to something in the interface (e.g., so you can 
change the label text). Use an IBAction when you want 
a control to tell your code when something happens (like 
the button gets pressed). 
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actions and outlets 


Fireside Chats 

華華 


Tonight’s talk ： IBActions speak louder than... a lot of things 


IBAction: IBOutlet: 

Hi, Outlet. What’s it like to only be an enabler? 

What are you talking about? I do stuff. 

Uh 一 I’m an Action, all about doing. My job is to 
kick off a method when something happens — an 
event. That’s getting something done. You just sit 
there and point to stuff going on. 

Big deal. At least I’m aware of everything going on. 

Yeah, but when the user does something, I make it 
happen! I do the saving, I do the actual clicking! 

Listen, it’s true that I’m just an instance variable 
that works with an object in a nib, but that doesn’t 
mean I’m not important. 

Really, because the compiler just ignores you! 

It does, but I tell Interface Builder a lot. You’re not 
very tight with IB, are you? 

Well, for starters, the “IB” in IBAction stands for 
Interface Builder! 

、 Big deal, I have “IB” in my name, too. 

Well, we do have that in common. Anyway, 

Interface Builder knows when I’m around that some 
event in a nib can set me off and keep me informed. 

Well, I guess that is pretty important. 

Thanks. That’s nice of you to admit. 
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getting started 


IBAction: 


Care to explain? 


Oh—I see. You know, there is one thing that you 
have that I’ve always wanted. 


You can be anything! Stick IB Outlet in front of 
any variable name and you’re good. I have more 
complicated syntax, because I need to have the idea 
of a sender in there. 


Me too. 


IBOutlet: 

But I’m secure in my relationship with Interface 
Builder. Without me, the code couldn’t change 
anything in the UI. 

Sure. An IBOutlet variable can point to a specific 
object in the nib (like a text field or something), and 
code (yes, probably your code) can use me to change 
the UI, set a text field’s content, change colors, etc. 


What’s that? 


I do like the freedom! Glad we could work things 
out. 




TesT DriVq 


Now that everything is hooked up, it's ready to run. Make sure that you save in Interface 
Builder and then go back into Xcode and build and run. 
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mi/ce's on his way 




TesT DriVq 



It works! 



6jd a message Keve! 
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O 


0 





Mike can make at least one 
decision. 

Your app is working! All the pieces are 
fitting together: the 氺 .xib file describes the 
interface, Interface Builder has connected it 
to the code, and Objective-G is making it all 
work together. 



You’re on your way to heing 
on tke App Store. 


How about a Twitter app? 
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a little recap 


What is that File’s Owner thing? 


Interface Builder has an expectation 
of what class will be the nib’s File’s Owner. 
You can change what class Interface Builder 
thinks it will be, but by default a new project 
is set up so that the main View Controller 
created by Xcode is the File's Owner for 
the main view created by Xcode. That’s 
why we didn’t have to change anything. 
Since the File’s Owner is set up to be our 
iDecideViewController, Interface Builder 
could look at the iDecideViewController 
header and see we had an 旧 Outlet named 
descriptionText and an IB Action named 
button pressed. When you connected 
the UlLabel’s referencing outlet to File’s 
Owner descriptionText, Interface Builder 



saved the information necessary so that 
when the nib is loaded by the application, 
the references are set correctly in our 
iDecideViewController. The same thing 
happened with the TouchUpInside event, 
except in this case instead of hooking up a 
component to a reference, it hooked up a 
component’s event to a method that should 
be called. 

Beware—Interface Builder’s expectation of 
the class that will load the nib does not mean 
that other classes can’t try—it just might 
not work well if that class doesn’t have the 
necessary properties and methods. 

What’s with the “Outlet” stuff? 

Interface Builder has the idea of 


Outlets and Actions, and well talk more 
about them in a bit. Basically an Outlet is a 
reference to something and an Action is a 
message (method) that gets sent (called) 
when something happens. 

Why does our new text string have 
an @ in front of it? 

Cocoa Touch uses a string class 
named NSString for its text strings. Since 
it’s so common, Objective-C has built in 
support for creating them from constants. 
You indicate a string constant should be an 
NSString by putting an @ symbol in front of 
it. Otherwise, it's just a normal char* like in 
C or C++. 


BULLET POINTS - 

■ Interface Builder creates nib files (with a 
■xib extension) that describe the GUI in 
XML 

■ Nib files are loaded by the Cocoa Touch 
framework and are turned into real 
instances of Cocoa Touch classes at 
runtime. 

■ In order to connect the components 
described in a nib to your code, you use 
旧 Outlets and 旧 Actions. 


■ Xcode is where your code and files are 
maintained for your application. 

■ Xcode is the hub for your project 
development and offers support for editing 
your code, building your application, and 
debugging it once it’s running. 

■ The iPhone Simulator lets you test your 
application on your Mac without needing a 
real device. 
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Match each iPhone development item to its description. 


Item 


Description 


IBOutlet 


A typical iPhone plan that is different 
from most other mobile phones. 


Functions of Xcode 


Xcode ， Instruments, Interface Builder, 
and the iPhone Simulator. 


Unlimited data usage 


Reference from the code to the 
interface. 


IBAction 


Images, databases, the icon file, etc. 


Components of the SDK 


Application resources 


Maintaining and editing code and 
resources, debugging code, and 
preparing an app for deployment. 


Indicates a method that can be called 
in response to an event. 
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who does what solution 





* 




Match each iPhone development item to its description. 


Item 


工 BOutlet 


Functions of Xcode 


Unlimited data usage 


工 BAction 


Components of the SDK 


Application resources 


Description 



A typical iPhone plan that is different 
from most other mobile phones. 


Xcode, Instruments, Interface Builder, 
and the iPhone Simulator. 


Reference from the code to the 
interface. 


Images, databases, the icon file, etc. 


Maintaining and editing code and 
resources, debugging code, and 
preparing an app for deployment. 


Indicates a method that can be called 
in response to an event. 
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iPhonecross 

Bend your brain around some of the new 
terminology we used in this chapter. 



Across 

4. Something that the simulator cannot reliably test. 

5. This is used to set up an outgoing connection from the 
implementation code to the view. 

7. The term to describe each screen of an iPhone app. 

8. The framework used to write iPhone apps. 

10. The folder used to organize the images for the app. 

12. The name of the IDE for iPhone apps. 

13. These are used in Xcode to provide classes to be accessed. 


Down 

1. The language used to write iPhone apps. 

2. This is used on a desktop to test an app. 

3. This is used to recieve an event in code and trigger 
something. 

6. This is the name of the editor used for Objective-。. 

9. The iPhone is this kind of device. 

11. The name of a file used to create a view. 
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iPA?or?ecross so/tif/on 



iPhonecposs Solution 

Bend your brain around some of the new 
terminology we used in this chapter. 



Across 

4. Something that the simulator cannot reliably test. 
[PERFORMANCE] 

5. This is used to set up an outgoing connection from the 
implementation code to the view. [ 旧 OUTLET] 

7. The term to describe each screen of an iPhone app. [VIEW] 

8. The framework used to write iPhone apps. [COCOATOUCH] 
10. The folder used to organize the images for the app. 

[RESOURCES] 

12. The name of the IDE for iPhone apps. 
[INTERFACEBUILDER] 

13. These are used in Xcode to provide classes to be accessed. 
[FRAMEWORKS] 


Down 

1. The language used to write iPhone apps. [OBJECTIVEC] 

2. This is used on a desktop to test an app. [SIMULATOR] 

3. This is used to recieve an event in code and trigger 
something. [ 旧 ACTION] 

6. This is the name of the editor used for Objective-C. 
[XCODE] 

9. The iPhone is this kind of device. [MOBILE] 

11. The name of a file used to create a view. [NIB] 
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getting started 



Your iPhone Toolbox 


You’ve got Chapter 1 under your belt 
and now you’ve added basic IPhone app 
interactions to your tool box. For a complete 
list of tooltips in the book, go to http://www. 
headfirstlabs.com/iphonedev. 



Views arc constructed iw Interface Guilder 

A view is made up of nib (*.xib) files and the GUIs are edited 
with Interface Builder. 



...then the code that makes the views work. 

This code is almost always written in Objective-G using 
Xcode. 



•••and any other resources, all packaged into 
your application. 

Images and other data are referenced together in Xcode so 
that all of the files that you need can be easily dealt with. 


you are 


here ► 
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2 !p}ione app patterns 






Hello @twitter! ♦ 



©grandmom please bring me some soda 
rm so over the milk. #babyrants 




Apps have a lot of moving parts. OK, actually, they don’t have any real 
moving parts, but they do have lots of Ul controls. Atypical iPhone app has more going on 
than just a button, and it’s time to build one. Working with some of the more complicated 
widgets means you’ll need to pay more attention than ever to how you design your app, 
as well. In this chapter, you’ll learn about some of the fundamental design patterns used in 
the iPhone SDK, and how to put together a bigger application. 


this is a new chapter 


mike needs your help again 







Mike is back. He has a great girlfriend, Renee, but 
they’ve been having some problems. She thinks that 
he doesn’t talk about his feelings enough. 


0 


O 


O 


A Twitter app is the way to go here. 

That would be perfect ： I can just tweet 
about my feelings and then shell be happy. 


There’s (about to be) an app for that. 



Using some solid design and the basic controls 
included in the Interface Builder library, you can 
have Mike posting to Twitter in no time. But first, 
what should his tweets say? 
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First wc weed to figure out 
what Mike (really) wants 


Mike isn’t a complex guy. He wants an easy interface to 
talk to Twitter and he really doesn’t want to have to type 
much. 


ttevVs Mike 
hdhded you a-t 七 he 
o( -the 


Wert 


s 


YiVv 


at 1 一七 : 





^ 切 ㈣ 


\\ok, 

^ U^i ^ ^ 

“匕 ㈣ 一 ^* 




App Magnets 


Now that we know what Mike wants, what do we need to do? Take 
the magnets below and put them in order of the steps you’ll follow 
to build his Twitter app. 
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start with the app layout 



App Magnets Solution 

Now that we know what Mike wants, what do we need 
to do? Take the magnets below and put them in order 
of the steps you’ll follow to build his Twitter app. 


MW ―义二 



C\\OSCY\- 


Figure out how to use 
the controls 


Before you s-tav-b tod •” 
sVtieM 七 

youVc 七 Wmk … 






Wcirc wc y\eeA . 






tW^iare no o 

Dumb Questi9ns 


How do you figure out the app 
layout? 

We're going to give you a couple to 
choose from to get started, but in general, 
it’s important to think about what your app 
needs to do and focus on those features first. 

Are we always going to start with a 
sketch? 

Yes! Good software design starts 
with knowing what you’re building and how 


the user is going to work with the app. The 
app for Mike is going to work with Twitter, 
and he’s going to be able to make some 
selections for his feelings and thoughts. 
That’s it! 

How do we talk to Twitter? 

Don’t worry, well give you some code 
to help you to work with that. 

Just FYI, though, Twitter has a really well- 
documented API. Well give you what you 
need, but feel free to add more features! 


Does every control work differently 
than the others? 

For the most part, no—once you learn 
a few basic patterns, you’ll be able to find 
your way through most of the SDK. Some 
of the controls have a few peculiarities here 
and there, but for the most part they should 
start to look familiar. 
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APP LAYOUT COIXSIIUJCIIOIX 1 

Here are two designs to evaluate. Based on 
aesthetics, usability, and standard iPhone app 
behavior, which one is better for Mike? 


Option #1 


TWrbta 

URL hcvc 



U 此 S0 

mscvt 3 to^\t 
0^ 


usev 灼 awe 

、 _ 

(or yass^ovd 




Option #2 


Ua\>e's 

Yi»\\ V)C 〆 L 

o( 


mstaTv/i-t 


hello 

wovldmj 


dV/CSon\C 


about it 


Sc^d Button 


Coy\\x° ^ 
S(\WtA ^ …办 
a 6 *tw'»fccs 
心 cV» 呼 


The bu-t-toh will 
have useir i h 4 ahd 
一 p^oh-Pigu^d 


Which app is better? 
Why? (Be specific.) 


Why not the other? 
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keep it simple 


APP MYOIJI CONSIRIJCIION 

We’ve given you two designs to evaluate. Based 
on aesthetics, usability, and standard iPhone app 
behavior, which one is better for Mike? 


Option #1 



H ⑽ & 

bu “ w d。bd 




take cdxt o\ tvus 


6cm*tx*ol s 乇、 S 


^ ,s ^ihd he L I U f C，r 

do Wh . the 卿 k sh u { 


Which app is better? … • 井 ？ :' . 

Why? (Be specific.) Option 养 Z Kas a lot less -typing dr\d -fewev- -fields ovcv-all 

Smde *the user doesn't r\ttd *to his usev-hame or password o-f-tc^ 七 here’s ho reason bo pu*t 

i*t oy\ *thc md'm view cvevy *time he v-u^s *the app. 

Why not the other? Option has a 1 。七 o*f and sc-ttm^s *bo v-emdnabev. The buttons are doh-fusm^. 


42 Chapter 2 



































iPhone app patterns 






as a 


¥於 二 


arovAV' 
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/ wovldmj 
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vcw 
IXRU 



Ustcad V^avm^ M«kc t/?c 

v/ C w r c w a r .., 

^om. TW»s mcav^s W'r o?t»o^s 
七十 but 

is y/ 37 casicv -to ^ ay.a C S 
yle yj>j all,— 七， 


s'mdc 


Tkis is tke one 
you’re going to 

Luild for Mike. 


tJiereiare no o 

Dumb Questi9ns 


Do I really need to care about usability and aesthetics so 
much? 

Usability and aesthetics are what made the iPhone a success, 
and Apple will defend them to the death. Even more importantly, you 
don’t get to put anything on the App Store or on anyone else's iPhone 
without their approval. Apple has sold over a billion apps—if yours 
doesn't fit with the iPhone look and feel or is hard to use, people will 
find someone else's app and never look back. 

We got rid of the username, password, and URL fields. 

The URL one I understand, but what about the other two? 


Anytime your app needs configuration information that the user 
doesn't need to change frequently, you should keep it out of the main 
task flow. Apple even provides a special place for these called a 
Settings bundle that fits in with the standard iPhone settings. We're 
not going to use that in this chapter (well just hardcode the values) 
but later well show you how to put stuff in the Settings page. That’s 
usually the right place for things like login details. 

How am I supposed to know what Apple thinks is good 
design or aesthetically pleasing? 

Funny you should ask... go ahead, turn the page. 
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whafs your (app) type? 


App design rules—the iPhowc Hit 


The iPhone Human Interface Guide (HIG) is a document that Apple 
distributes for guidance in developing iPhone Apps for sale on the App 
Store. You can download it at http:/ / developer.apple.com/iphone. This 
isn’t just something nice they did to help you out; when you submit an 
app for approval, you agree that your app will conform to the HIG. 


We can’t overstate you have to follow the HIG, as Apple’s 

review process is thorough and they will reject your application if it 
doesn’t conform. Complain, blog with righteous anger, then conform. 
Now let’s move on. 

Apple also distributes a few other guides and tutorials, including the 
iPhone Application Programming Guide. This is another great source of 
information and explains how you should handle different devices, like 
the iPhone and the iPod Touch. Not paying attention to the iPod Touch 
is another great way to get your app rejected from the App Store. 






Immersive Apps 


Application types 


The HIG details three main types of applications that are commonly 
developed for the iPhone. Each type has a different purpose and 
therefore offers a different kind of user experience. Figuring out what 
type of application you’re building before you start working on the 
GUI helps get you started on the road to good interface design. 



a\rc a dassk example, bui like -thi _ _ 

all ir^e\rsWe apps \rc<\ui\rc a vcv-y dusW rntev-fade -that 
allows -the usc\r io with -the device. M a vesuli 
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Productivity Apps 



Utility Apps 
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m 





m 


Below are a bunch of different application ideas. For each one, think about what kind 
of app it really is and match it to the app types on the right. 


App Description Type of App 

InstaTwit 1.0: Allows you to tweet 
with minimal typing. 


News Reader: Gives you a list of 
the news categories and you can 
get the details on stories you 
choose. 


immersiVe Appli^cition 


Marble Game: A marble rolling 

game that uses the accelerometer Udlfty Appli^ctti°n 

to drive the controls. 


Stopwatch Tool: Gives you a 
stopwatch that starts and stops by 
touching the screen 


Productivity Appliccttfon 


Recipe Manager: A meal listing 
that allows you to drill down and 
look at individual recipes. 
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who does what solution 


♦ 







* 




Match each app description to its application type. 


App Description 


InstaTwit 1.0: Allows you to tweet 
with minimal typing. 




ihis / \ pp 

hds <3 lisi^^ f News Reader: Gives you a list of 
如 "- do^/ h ,Ve 〜 the news categories and you can 

get the details on stories you 

Pfr <=>du£ii V i{y 


choose. 


Us\y\^ tV'C 

a66c\cvowcW 
as 

a 

voWmOy mavWc - 

v^ 3 ^*b 3 
vev*Y -focused 

S^O 卜 Uh 糾， 

y\o vc3l d3"t3 
W>vk -b^vou^ 


Marble Game: A marble rolling 
game that uses the accelerometer 
to drive the controls. 


Stopwatch Tool: Gives you a 
stopwatch that starts and stops by 
touching the screen 


Recipe Manager: A meal listing 
that allows you to drill down and 
look at individual recipes. 


Lots o( data -to 
wo\rk tli\rough hcvc ： 
■titles, a dv-ill-dov/h 
■to \rcdipcs-dc-fihi-tcly 
fv-odudiivi-ty 


Type of App 

wc have ohc s^vcch 
and ho typi h g ; /hstaTwit is 
of a Utility App 



immersiVe Appfcqtfcn 


Utility Appliccttlon 


Productivity Appli^cttion 
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Hit guidelines for pickers and 
buttons 


The HIG has a section on the proper use of all the standard 
controls, including the two that we’ve selected for InstaTwit. 
Before you build the view with your controls, it’s a good idea to 
take a quick look at the recommendations from Apple. You’ll find 
this information in Chapter 9, Application Controls, of the HIG. 



The v*ouhdcd buttoh 

is pv-etty stiraigli-t-fovy/av-d, but 
keeg ih rwihd it should dlwdys 
some kihd of a^tioh. 
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a new view 


Create a new View-based project 
for IwstaTwit 


Once you’ve started Xcode, select File ^ New Project. 
Just like iDecide, for InstaTwit we have one screen and we’re 
not going to be flipping it or anything fancy, so again choose 
the View-based Application and name it Inst a twit. 



Watch it! 


a ^ ^ 



ln^lJr1wfVa^Hrt, n |^ lern 
軸鯖 5«tirvc3 

、 Wap'.WinriiHi ufa 

L InKUfi^^HnlD.DRic 

駟 Igj Pnxlucu 

齡 ■Alfltifc 


« C-rcptcd br IrjBCtT Pllpfic 

En_Fr|igh*l — 麵 


The new project type is not necessarily the 
same as your app type. 


For example, a Productivity App can be written as a 
View-based Application, a Window-based Application, 
Navigation-based Application, or a Tab Bar Application. 



be v/ovk»^^ 

i^ts bW •，▲ book. 


Start with the view layout 


Now that we have the autogenerated code, we’re going to start working with 
the interface. To do that, we’ll be editing the nib (.xib) file. Double-click on 
InstatwitViewGontroller.xib in the Resources folder, and launch Interface Builder. 
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iPhone app patterns 



It’s time to build the View. Using drag and drop, pull over 
the elements from the Interface Builder library that you 
need to build the view. 



Find each of the elements (we’ve given them the 
proper name for you) in the library and drag and 
drop them into the View window. 
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i urg^E ab^E nrhrf k 
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a^ndi. on EN^n Ji Ijrgi 


❺ Select the top label and hit §€ 1. That will 
launch the Inspector. 


tdvt label 
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Edit the labels and button text for the title, 
‘Tm’’，“and feeling’’，and “about it’’，as 
well as the title for the button. Don’t worry 
about the picker values just yet. 


Once you save it, your 
view should look like 
this... 
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preview your view 




The View is all built and ready to go. Here’s what you should 
have on your screen now. Once you tweak everything to look 
just how you want it, well run InstaTwit. 



label 


Fillip ih pidkev data v-c<\uivcs some 

toAt } ahd wc II get -to that ih a mihuie. 
I^Vhat you see kvc av-c default values. 



TKc ihsped-tov- -fov- 
but-fcoh is 

slightly di-Pfcvcht— 
the title is 
-Pu\rthc\r dov/h m 
the v/mdow. 


Did you ho-tidc the blue 3 uidelihes the simulaW? 

TheyVe ih the view whch youVe layihg out demits 

you u^itY thihjs ahd keep ther, Imed up with 
o*thcv-. 
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TesT DriVq 


Now it’s time to check out InstaTwit in the 



Simulator. Save in Interface Builder, go back into 
Xcode, and hit Build and Debug from the Build 
menu ( or 昶 return). 


丁 he pitkcv isk /七 
showing up bemuse 

data yet... 





To get the picker to show, it needs to have data to 
fill it. Where do you think that the code for the data 
should go? 
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the view-view controller relationship 


The life of a root view 

In Chapter 1 we touched on how Interface Builder creates XML 
descriptions of your view，called a nib, and that the Cocoa Touch 
framework turns that into a real view in your application. Now 
that you’ve built a couple apps, let’s take a closer look at what’s 
going on under the hood. 


o 


o 


Like in most other languages, main(...) gets called first. 

When your application is launched by the user, the iPhone provides a 
quick animation of your app zooming into the screen (this is actually a 
PNG file you can include with your app), then calls your main method. 
Main is provided by the templates and you almost never need to touch it. 


Main kicks off a Cocoa Touch Application. 

The standard main (…） kicks off a Cocoa Touch 
UIApplicationMain, which uses the information in 
your application’s Info.plist file to figure out what nib 
to load. With the View template we used, it’s a nib 
called MainWindow.xib. 



MainWindow.xib contains the 
connections for our application. 

If you look in MainWindow.xib, 
you’ll see it has an instance of 
our InstaTwitAppDelegate, for its 
UIApplicationDelegate and an instance 
of our InstaTwitViewG ontroller. 

When the Cocoa framework loads this 
nib, it will create an instance of our 
InstaTwitVie wG ontroller and tell it to 
load our InstaTwitViewGontroller.xib. 





r Wls ' ls ^ 1/icw 


^o\rc 


So °^) ioo. 


InstaTwitViewController 
instantiated from 
MainWindow.xib , 

Ikt a-d atW 6 T Wtt ^ 

“丁參‘。“。 
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The Cocoa Touch framework 
creates our custom view from the 
InstaT witViewController. xib. 


ouv view. 





When we constructed the nib, we used the 
File’s Owner proxy object to stand in for 
the object that owns the nib contents. At 
this point the framework is loading the nib 
on behalf of our InstaTwitViewG ontroller 
class so that instance is used for connections. 
As the framework creates instances of our 
components, they’re connected up to the 
instance of InstaTwitVie wG ontroller. 


hib f ， l c scv .j a |j , 

be ，—細 … 


When events occur with components, methods 
are invoked on our controller instance. 

The actions we associated between the controls and the 
File’s Owner in the nib were translated into connections 
between the controls and our instance. Now when a 
control fires off an event, the framework calls a method 
on our InstaTwitViewGontroller instance. 


Vow let’s put tkis 
knowlectgfe to use and aetd 
some data for tke picker. 
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no dumb questions 


Isn’t good design vs. bad design a 
little subjective? 

Yes and no. Obviously, different 
people will have differing opinions about 
what UI looks better. However, Apple has 
very specific guidelines about how certain 
controls should be used and best practices 
that should be followed. In general, if you’re 
using a common iPhone control, make sure 
you're using it in a way that’s consistent with 
existing applications. 

How can I run these apps on my 
iPhone? 

To get an app you write installed 
on your iPhone you'll need to sign up for 
either the Standard or Enterprise Developer 
programs at http://developer.apple.com/ 
iphone/. Everything in this book is designed 
to work with just the Simulator, so don’t feel 
like you need to go do that just yet. We’ll talk 
more about putting apps on an actual phone 
later in the book. 


tJiereiare no ^ 

Dumb Questi9ns 


The InstaTwit icon looks horrible. 
What can I do? 

The icon for an application is just 
a PNG file in your project. We'll add and 
configure icons later, but for now, just know 
that you'll need a .png file in the resources 
directory for that purpose—well hook you up 
with some cool icons later. 

Q/ Do I have to use Interface Builder 
for the view? 

No. Everything that you do in Interface 
Builder can be done in code. Interface 
Builder makes it a lot easier to get things 
started, but sometimes you’ll need that code¬ 
level control of a view to do what you want. 
Well be switching back and forth depending 
on the project and view. 

I’m still a little fuzzy on this nib 
thing. Do they hold our Ul or regular 
objects? 


They can hold both. When you 
assemble a view using Interface Builder, it 
keeps track of the controls you’re using and 
the links to other classes. These controls 
are serialized into an XML document; when 
you save it out, this is your nib. Interface 
Builder is able to serialize non-control 
classes, too. That’s how it saves out our 
InstaTwitViewController in MainWindow.xib. 
When the nib is restored from disk, objects 
in the nib are reinstantiated and populated 
with the values you gave them in Interface 
Builder. 

So does Interface Builder save out 
the File’s Owner too? 

No, File's Owner is a proxy. File's 
Owner represents whatever class is asking 
to have this nib loaded. So the File’s Owner 
proxy isn’t actually stored in the nib, but 
Interface Builder needs that proxy so you 
can make association with controls you used 
in your view. When the nib is restored (and 
the control objects are instantiated), the nib 
loading code will make the connections to the 
real owning object that asked to load the nib. 
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First get the data from Mike 

Mike likes what you have put together for the UI, so 
now we need a little more information before we fill 
the picker. 



O 


0 


I like the interface. Here's my list of 
what I do and how I feel about it so you 
can fill in the rest. CaiVt wait until ifs done 
because I*m soooo over talking about it... 






This data will be used as part of the picker, but how 
do you implement that? 
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when to pick a picker 


Use pickers whew you wawt 
controlled input 


In our case, the picker is the perfect element for our 
app. No typing at all, but it allows Mike to have 
some input over what gets selected. There’s some 
terminology that you need to know about pickers 
before we get our data in there. 


The hurhbcm of v-ows^ 
饮 心％ 4oi 

s lisi so 

W 匕 h ^ornpohCh-t ， 



Wfc y/an*t 4>/o 乙 oluwms. 
TV^C pitkcv tails 
tow>foy\cr\*ts- 







When iw doubt check out Apple’s API 
documentation 



c 收 ^ fcrence 


u \P\ckerV\e^ 




By now you’re already thinking about how to implement that 
picker. It’s time to get into the API documentation. In Xcode 
go to the Help menu and then the Documentation option 






Search for “UlPickerView” and it will pull 
up all the information on the class that you 
need to implement for the picker. 
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Fill the picker rows with 
Mike's data 


The picker needs to know how many rows it needs and 
how many columns. And that information is tied to the 
words that Mike provided. 


OK, so we can just set the picker rows 
with the values Mike gave us like we did 
with the button label, right? 


The picker is different. 

The picker doesn’t want to be told what 
to do, it’s going to ask when it wants your 
input. You’re going to see this pattern 
show up with controls that could use a lot 
of data like pickers and later, table views. 
Let’s take a closer look... 
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datasources and delegates 


Pickers get their data from a datasource 


Most of the elements in the Cocoa Touch framework have the concept of 
datasources and delegates. Each UI control is responsible for how things look 
on the screen (the cool spinning dial look, the animation when the user spins 
a wheel, etc.), but it doesn’t know anything about the data it needs to show or 
what to do when something is selected. 

The datasource provides the bridge between the control and the data it 
needs to display. The control will ask the datasource for what it needs and 
the datasource is responsible for providing the information in a format 
the control expects. In our case, the datasource provides the number of 
components (or columns) for the picker and the total number of rows for the 
picker. Different controls need different kinds of datasources. For the picker, 
we need a UIPickerViewDatasource. 



Datasource 


and tell their delegates whew something happens 


A delegate is responsible for the behavior of an element. When someone 
selects something — or in this case, scrolls the picker to a value — the control 
tells the delegate what happened and the delegate figures out what to do in 
response. Just like with datasources, different controls need different kinds of 
delegates. For the picker, we need a UIPickerViewDelegate. 



Why is the delegate providing the content? That really seems like data. 

That’s something particular to a picker and it has to do with the fact that the picker delegate can change how the data is shown. In the 
simplest form, it can just return strings to the picker. If it wants to get fancy, it can return the entire view (yes, just like the view you built with 
Interface Builder, but smaller) to use images or special fonts, whatever. 
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There's a pattern for that 


You’re going to see this Control-Datasource- 
Delegate pattern show up throughout the rest of 
this book. Nearly all of the complex controls use it. If 
you squint a little, even the View-View Controller 
relationship we’ve been using follows this pattern (minus 
the datasource). 


4 咐 d •〜卿 





Controls have their own specific 
datasources and delegates 


I do^vol 

vour user V/.II • 十: 把七 

V , 七 w —_， ’，七 i w 
assembled Wi-tV. I^adc 

todc, -too. Ut^ 

如 and dvav/ba d 

一 Wes —“ scbo 七“ 

i\\t sa^c 


6o ^o\s H 一⑽ 


Each control has specific needs for its datasource and delegate and 
we’ll talk about how that’s handled in Objective-G in a minute. 
However, it’s important to realize that while the responsibilities are 
split between the datasource and the delegate in the pattern, they 
don’t necessarily have to be implemented in different classes. The control 
wants a delegate and a datasource — it doesn’t care whether they’re 
provided by the same object or not: it’s going to ask the datasource 
for datasource-related things and the delegate for delegate-related 
things. 

Let’s take a closer look at how the UlPicker uses its datasource and 
delegate to get an idea of how all of this fits together. 
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picking apart the picker 



The PicKev E 印 ose 』 

This week’s interview: 

How to avoid spinning out of 
control... 


Head First ： Hello Picker, thanks for joining us. 

Picker ： My pleasure. I don’t usually get to talk to 
anyone but my datasource and delegate so this is a 
real treat. 

Head First ： I’m glad you brought those up. So 
we’ve worked with controls like buttons and labels, 
but they just have properties. What’s going on with 
this delegate and datasource business? 

Picker ： Well, to be clear, I have properties too — 
there just isn’t too much exciting going on there. 
What makes me different is that I could be working 
with a lot of data. I might only have one row or 
I might have a hundred; it just depends on the 
application. 

Head First ： Ah, OK. A label only has one string in 
it, so there can be a property that holds that string. 

No problem. 

Picker ： Exactly! So, instead of trying to cram all of 
the data into me directly, it’s cleaner to just let me ask 
for what I need when I need it. 

Head First ： But you need to ask for it in a specific 
way, right? 

Picker ： That’s the beauty of my setup. I ask for 
what I need to know in a specific way — that’s why 
there’s a UIPickerDatasource — but I don’t care 
where my datasource gets its information. For 
example, I need to know how many rows I need to 
show, so I ask my datasource. It could be using an 
array, a database, a plist, whatever — I don’t care. All 
I need to know is how many rows. 

Head First ： That’s really nice — so you could be 
showing data coming from just about anything, and 


as long as your datasource knows how to answer 
your questions, you don’t care how it stores the data 
internally. 

Picker ： You got it. Now the delegate is a little 
different. I can draw the wheels and all that, but I 
don’t know what each application wants to do when 
someone selects a row, so I just pass the buck to my 
delegate. 

Head First ： So whichever one implements the 
delegate, it codes things so that when you tell it what 
happened, it performs the right action, like saving 
some value or setting a clock or whatever.... 

Picker ： That’s it. Now, I have to confess I have one 
little oddity going on... 

Head First: Oh, I was waiting for this... this is 
where you ask the delegate for the value to show in a 
row, right? 

Picker ： Yeah 一 other controls ask their datasource. 

I could come up with a lot of excuses, but... well, we 
all have our little quirks, right? 

Head First ： I appreciate your honesty. It’s not all 
bad, though; your delegate can do some neat things 
with each row, can’t it? 

Picker ： Oh yeah! When I ask the delegate for a 
particular row, it can give me back a full view instead 
of just a string. Sometimes they have icons in them 
or pictures — really, anything you can cram in a view, 
I can display. 

Head First ： That’s great. Well, we’re out of time, 
but thanks again for stopping by. 

Picker ： My pleasure! Now I’m off to take my new 
datasource for a spin... 
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—— 9 黾■雀 - 

雜 

Match each picker characteristic to where it belongs — the delegate or 
the datasource. You’ll need to go digging in the API to figure out where 
the three methods go. 


picker characteristic (or method) 


Delegctte or dettasource? 


Directions for drawing the view 
for the items 


The number of components 


Delegate 


pickerView : numberOfRowsInComponent 


pickerView : titleForRow : forComponent 


Datasource 


The row values (strings or views) 


numberOfComponentsInPickerView 


Working togetker, tke delegate 
and tke datasource provicte wkat 
is neected to rencter tke picker. 
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picker parts 


+ 






Match each picker characteristic to where it belongs — the delegate 
or the data source. You’ll need to go digging in the API to figure out 
where the three methods go. 


picker characteristic (or method) 


Delegctte ox dcttcisource? 



f 

V f\ vecyu'ired f av-t o( i\\c U |P*itkc\r\/*ic>Mpa*taSou\rdc 
Pv-0*todol ； VC*tuVl^S v>umbcv o( domfoir>Cir>*U- 
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O 


o 



Hang on—there are protocols in both the datasource 
and the delegate? 


Protocols define what messages the datasource 
and delegates need respond to. 

Pickers (and other controls that use delegates and datasources) 
have specific messages to which their supporting classes need to 
respond. These messages are defined in protocols. Protocols are 
Objective-C’s idea of a pure interface. When your class can speak 
a particular protocol, you’re said to conform to it. 



uscv^ust^ 


S^\AY\ me 


■fco \ovj i . 




So how mSv\y vov/s 

do 

you meed? 



iVhats -the wov-d 
(or \rov/ S? 







Protocols tell you what methods 
(messages) you need to implement 







Protocols typically have some required methods to implement and others that 
are optional. For example, the UIPickerViewDatasource protocol has a required 
method named pickerView : numberOf Rows InComponent; it has to be in 
the datasource for the picker to work. However, UIPickerViewDelegate protocol has 
an optional method named pickerView : titleForRow : f orComponent, so 
it doesn’t need to be in the delegate unless you want it. 

So how do you know what protocols you need to worry about? The documentation 
for an element will tell you what protocols it needs to talk to. For example, our 
UlPickerView needs a datasource that speaks the UIPickerDataSource protocol and 
a delegate that speaks the UIPickerDelegate protocol. Click on the protocol name 
and you’ll see the documentation for which messages are optional and which are 
required for a protocol. We’ll talk more about how to implement these in the next 
chapter; for now, we’ll provide you the code to get started. 
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sometimes it’s okay to conform 


First declare that the controller conforms to both 
protocols 

Now that you know what you need to make the picker work, namely a delegate and a datasource ， 
let’s get back into Xcode and create them. Under Classes you have two files that need to be edited: 
InstatwitViewGontroller.h and InstatwitViewGontroller.m. Both files were created when you started the 
project. 

The .h and .m files work together, with the header file (.h) declaring the class’s interface, variable 
declarations, outlets, and actions, etc.; the implementation file (.m) holds the actual implementation 
code. We need to update the header file to state that our InstatwitViewGontroller conforms to both the 
UIPickerViewDataSource and the UIPickerViewDelegate protocols. 


4 0 ^ add 

—V>o\ded’ 



^import <UIKit/UIKit•h> 



Qinterface 工 nstatwitViewController : UlViewController 

<UIPickerViewDataSource , UIPickerViewDelegate> { 

NSArray* activities; 

NSArray* feelings; 


tWs ^ savf ouv- 
tlass Will to the 

U |P ， 6kevV_ ， cv/Pa*ta SouV ^ 

av ,a UP ， 6kcvV，P 抑 te 



[ WcVc jomj set up tv/o a^ays U 
-f 0 \r activities -for 呼 . 




InstatwitViewController.h 


Next add Mike's activities and feelings to the implementation file 

Now we’re into InstatwitViewGontroller.m file, the actual implementation. We’ll need to add 
some methods to implement the required methods from the protocols, but we’ll get back to that in 
a second. First, let’s add the list from Mike. We’re going to use the two arrays we declared in the 
header to store the words that Mike gave us. 
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#import ''InstatwitViewController. h" 

@implementation 工 nstatwitViewController 


\y\ 

deader 





InstatwitViewController.m 
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Remove /* W'av-ks v/c^rc V^crc ar.a add ^ tod ' 

TW,S 4od y*b id o”ou_ ^tvoll^ aU，^ _ 

• IS loaded W i\^t .%»b ^»lc. TW»s *»s y/^rc you do some 
*m*itiali^at»o^ av\d setup -for view. 


^7 


// Implement 

viewDidLoad to do additional setup after loading the view, 
typically from a nib. 

- (void)viewDidLoad { 

[super viewDidLoad]; 

activities = [[NSArray alloc] initWithObjects:@"sleeping' 
@ ’’eating’’ ， @’’working" , @’’thinking", @ ’’crying" , @’’begging ’’， 

@’’leaving’’ ， @’’shopping’’，@"hello worlding", nil]; 

feelings = [[NSArray alloc] initWithObjects : Q^awesome^, 
@’’sad", @"happy", @"ambivalent", @"nauseous’’ ， @’’psyched' 
@’’confused", @’’hopeful’’ ， @’’anxious’’ ， nil]; 


P 靜 _S 53 S 



Hcv-c wc 

cs-fc^blish the 

3vvays with 
/Wikcs lists. 
_ “II ther, 

3 bit "to -fill 
the pi 匕 kev. 


ih 


InstatwitViewController.m 


3sscs use 


(void)dealloc { 

[activities release ]\ 
[feelings release]; 

[super dealloc]; 

L nd 




Y<ju r\ccd *to vclc3sc all *ti^csc 
objects -to c\c^ uf tv^c memory, as 
\?\\ov\t is small (so v\oi rnuA memov-y). 
W^’ll -talk aboiA-b memov-y a lo-t move m 
CV^aftcv- 


Now we just need tke protocols... 
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how many rows? 

The datasource protocol has two required 
methods 

Let’s focus on the datasource protocol methods first. We said 
in the header file that InstatwitViewGontroller conforms to the 
UIPickerViewDatasource protocol. That protocol has two required 
methods, numberOfComponentsInPickerView : pickerView and 
pickerView : numberOf Rows InComponent. Since we know we want 
two wheels (components) in our view，we can start by putting that method in 
our implementation file: 


ttcv-cs i\\t 

\rC^u'»V"cd 


two 

methods fo 




- (NSInteger)numberOfComponentsInPickerView:(UlPickerView *) 
pickerView { 〆 - - H oy/ 

return 2; 


»^dhy 

^ompohcivts? 


- (NSInteger)pickerView : (UlPickerView *) 
pickerViewnumberOfRowsInComponent : (NSInteger)component { 

if (component == 0) { ^ <>>> ^ ttow vows m 

They Con\t 

•(Vom d**f*fcv*c^*t 3vv"3yS) 
so y/c r\ccd *to 
■bV^crn scfcv-a-tcly* 

return [feelings count]; 


return [activities count]; 


else 






m 


Our second method needs to return the number of rows for each 


InstatwitViewController.m 


component. The component argument will tell us which component 
the picker is asking about, with the first component (the activities) being 
component 0. The number of rows in each component is the just the 
number of items in the appropriate array. 


Now tkat we kave tke metkocts implenientect, 
let’s wire it up to tke picker. 
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Connect the datasource just like actions 
and outlets 


Now that the datasource protocol is implemented, the data is in place and 
it’s just a matter of linking it to the picker. Hop back into Interface Builder 
to make that connection: 



h lisi f 仏 … h ， 

V 'CW, plus ,-t s class 

Right-click on the Picker in the view to bring 
up the picker connections box. 


Notice that the File’s Owner for this view is 
our InstatwitViewGontroller, which realizes the 
datasource and delegate protocols we need. You 
need to connect the picker’s dataSource to our 
controller, the File’s Owner. To do that, click 
inside the circle next to the dataSource, and drag 
over the to File’s Owner. 


Santa Clara 




w 5 

t 

— ^ 



•ibingurii 

1 ► RifcrcrKlngi iDiJtMi 

0 


L 




If you don’t save in Interface Builder, 
it won 9 t work! 

Xcode will run the last saved version, not 
anything else. 


On to tke delegate •“ 
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getting to a specific row 


There's just owe method for the 
delegate protocol 

The UIPickerViewDelegate protocol only has one required 
method (well, technically there are two optional methods, 
and you have to implement one of them). We’re going to use 
pickerView:titleForRow:forGomponent. This method has 
to return an NS String with the title for the given row in the 
given component. Again, both of these values are indexed 
from 0, so we can use the component value to figure out 
which array to use, and then use the row value as an index. 


^ ^ you 


夕 - (NSString *)pickerView : (UlPickerView *)pickerView 
titleForRow:(NSInteger)row forComponent:(NSInteger)component { 


Ouv- eMo\Ct o( iv/o rwethods, oy\c of 
which heeds -feo be irwplemerrted. 


switch (component) { 
case 0 : 

return [activities objectAtlndex:row]; 

case 1 : 

return [feelings objectAtlndex:row]; 

} 

return nil; 



*b^c s-tv-mj m av-v-ay a*t 
affV"opv"ia*bc lotatio^ — v*oy/ 0 is 
s*brmj, v*o>w I sctor\d) d 


(void)viewDidUnload { 

// Release any retained subviews of the main view 
// e.g. self.myOutlet = nil; 


TWis 

dr\d 



acts tailed as ,s ㈣ sWb do 广 

V.CW *»s unloaded. IA/C dor：i \t W 


Y\O^N, SO 


leave \i as *rt >was m i\\t -tcmpla-tc. 


InstatwitViewController.m 
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Save your work in Interface Builder, go back into Xcode and save 
that, and Build and Run (拥 return). When the Simulator pops up, 
you should see everything working! 


% ih ^osc dials - 七 hevVr 

-thihjs oh pike's 

l,si ay)d 赠 k ^cai! 
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InsEatA^V le^Controlle r.xib 
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UIRHUDHCr 

UlVr** 


and feeling" 
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UllJJVI 
yiLnifci 
Ullalvl 
UIKul^pn 
Llll jJvl 


[ Mountain View 


Sunnyvale 




O lnrUiLwiL?uudep]ry| 


Sitnta Cl arn 


fDudeiCi 


Right-click on the picker m the Picker again 
and bring up the connections window. 


lurkvrri'rp 


driffgurli 


The File’s Owner realizes the delegate protocol 
as well. Click inside the circle next to the 
delegate, and drag over the to File’s Owner. 


TWfliM It! 
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protocol options 


What happens if I don’t implement 
a required method in a protocol? 

Your project will compile, but you’ll 
get a warning. If you try to run your 
application, it will almost certainly crash with 
an “unrecognized selector” exception when 
a component tries to send your class the 
missing required message. 

What if I don’t implement an 
optional method in a protocol? 

That's fine. But whatever functionality 
that it would provide isn’t going to be there. 
You do need to be a little careful in that 
sometimes Apple marks a couple of methods 



as optional but you have to implement at 
least one of them. That’s the case with 
the UIPickerViewDelegate. If you don’t 
implement at least one of the methods 
specified in the docs, your app will crash 
with an error when you try to run it. 

Are there limits to the number of 
protocols a class can realize? 

Nope. Now, the more you realize, the 
more code you’re going to need to put in 
that class, so there's a point where you 
really need to split things off into different 
classes to keep the code manageable. But 
technically speaking, you can realize as 
many as you want. 


I’m still a little fuzzy, what’s the 
difference between the interface we put in 
a header file and a protocol? 

An interface in a header file is how 
Objective-C declares the properties, fields, 
and messages a class responds to. It’s 
like a header file in C++ or the method 
declarations in a Java file. However, 
you have to provide implementation for 
everything in your class’s interface. A 
protocol on the other hand is just a list of 
messages—there is no implementation. 

It’s the class that realizes the protocol that 
has to provide implementation. These are 
equivalent to interfaces in Java and pure 
virtual methods in C++. 


BULLET POINTS - 

■ The picker needs a delegate and a data- 
source to work. 

■ In a picker, each dial is a component. 


■ In a picker, each item is a row. 

■ Protocols define the messages your class 
must realize—some of them might be 
optional. 


70 


Chapter 2 






iPhone app patterns 



Now let’s get that button talking to 
Twitter... 

We got the picker working, but if you try out 
the u Tweet it!，’ button, nothing happens when 
something’s selected. We still need to get the button 
responding to Mike and then get the whole thing to 
talk to Twitter. 




Think about what we need to do to get the 
button working. What files will we use? What will 
the button actually do? 


you are here ► 


71 



an action-packed button 


The button needs to be 
connected to m cvewt 

We need to wire up the button like we did in Chapter 
1. Once Mike has selected what he’s doing and 
feeling, he’ll hit “Tweet it!” Then we need to get his 
selections out of the picker and send them to Twitter. 



I'Hlc bu-t-toh 



O 


O 


So we just need to go back to IB and wire 
up the TouchUpInside event again, right? 



Yes, tut wkat will we wire tkat event to? 





bvh I j [w E V ifwC m 1 靥 qd-r ■ 11 b 
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Without aw action your 
buttow won't work! 

We learned about actions in Chapter 1, and without 
one there won’t be anything in the connections 
window to wire up in Interface Builder. 


Here’s the action we created for the button press in Chapter 1: 


-( 工 BAction) buttonPressed : (id)sender; 



I 好二 \v\icr 
^\\Acr 


(atrj 



Si:: meihod ihai ^ ^ 


TW,s ete^t 
如 atW- 



We need to change both the header and implementation 
files for the InstatwitViewController. 



Start with the header and add an IBAction named sendButtonTapped. 



Then provide an implementation for that method in our .m file, and 
write a message to the log so you know it worked before sending to 
Twitter 
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add an action 




BcgRciSe 

o 


Declare your IBAction in the header file and 
provide the implementation in the .m file. 


#import <UIKit/UIKit•h> 

Qinterface 工 nstatwitViewController : UlViewController 
<UIPickerViewDataSource, UIPickerViewDelegate> { 

NSArray* activities; -p, m a / • . ,.,, ., 

丁 he \of\cho}f\ is wha-t allows the toAt 

NSArray* feelings; 一 ^ v-esp^d io a usev- v- C m C r ， bcv-... 


(IBAction) sendButtonTapped : (id) sender; 

R 


Dcdla\rc youv IB Action hc\rc so v/c da 灼 use rt 
•m the m -file and |r>ic\r-Padc Bui I dev- knows 
we have dd'tioir) dvdildble- 



InstatwitViewController.h 


- (void)didReceiveMemoryWarning { 

// Releases the view if it doesn't have a superview. 

[super didReceiveMemoryWarning]; 

// Release any cached data, images, etc that aren't in use 


Saw method dcdlav-atioh as the .1 


- (IBAction) sendButtonTapped : (id) sender { This will give you the 
NSLog(@"Tweet button tapped !"〉； 片 oh *thc dohsolc-- 

} 






InstatwitViewController.m 



o Lack and kook it up witk Interface Builcter... 
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Tesr DriVq 


Save, then Build and Run. You should get the “Tweet 
button tapped!” message in the console. 



Cwrtar ^ LI 33 


Irtsits Tpy-i ¥ I 0- 




jmfm 


awifeomp 


3 hoping 


Imw 






amdlvB^ent 


mm 


TwwC Vi 



So now we need to get the data 
from that picker, right? Would an IBOutlet 
be the right thing for that? 



O 


Yes! An IBOutlet provides a reference to 
the picker. 

In Chapter 1, we used an outlet to access and change 
the text field value on the button. Now, to gather up the 
actual message to send to Twitter, we need to extract 
the values chosen from the picker, then create a string 
including the label text. 

So far the picker has been calling us when it needed 
information; this time, when Mike hits the “Tweet it’’ 
button, we need to get data out of the picker. We’ll use 
an IBOutlet to do that. 
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getting the data from the picker 


Add the IPOutlet and property to 
our view cowtrollcr 

In addition to declaring the IBOutlet, we’ll declare a property 
with the same name. We’ll talk more about properties in the 
next chapter, but in short, that will get us proper memory 
management and let the Cocoa Touch framework set our 
tweetPicker field when our nib loads. 


Start with the header file... 



#import <UIKit/UIKit•h> 

Qinterface 工 nstatwitViewController : UlViewController 
<UIPickerViewDataSource, UIPickerViewDelegate> { 

IBOutlet UlPickerView * tweetPicker; ^ ^ dctUc a -field 

NSArray* activities; tlass tailed •bv/cctP'^kc'r. 

NSArray* feelings; 七 ype is a fomtev" *to 3 

UlP'itkcvV'ic^. 

©property (nonatomic, retain) UlPickerView* tweetPicker; 

( 工 BAction) sendButtonTapped : (id) sender; 


@end 


ficvVs ou\r outlet 
dc^ldlrd'tioh. This lets 
Buildcv* 
khov/ you have 
something "fco dohhCdt 
"to- (BOutlcts av-c 

actually ^dc-Pihcd -to 

no 七 liih》’ "tlicyVc \us£ 
TO\r (h-tev-fade 
Buildcv-. 


"The p\ropcv-ty -Pov- iv/cciPidkcv has sorwc 
merwo\ry options 七 ha 七 well 

rwo\rc m Chap 七 ev* 孓 



InstatwitViewController.h 
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...and then add the implementation. 


#import ''InstatwitViewController. h 〃 

@implementation 工 nstatwitViewController 

@synthesize tweetPicker; 





InstatwitViewController.m 


- (void)dealloc { 

[tweetPicker release] 

[activities release]; 
[feelings release]; 

[super dealloc]; 


@end 


v Thc ias-t thih0 you heed h> do with 
twcctPuikcir is vdcasc ouv io \i ^ 

— M 赠 y ^ ^\\ ^ badk to the 

w 啸 y Chapte, ^ wc p,o,is C . 


Wltat’s next? 
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connect the outlet to the code 


Connect the picker to our outlet 

You’re probably expecting this by now! Back into Interface Builder to 
make the connection from the UlPickerView to the IBOutlet in our 
view controller. Right-click on the UlPickerView, grab the circle next 
to the “New Referencing Outlet,” and drop it on File’s Owner — our 
InstatwitViewGontroller sporting its new tweetPicker outlet. 


A ^ -1^ 






fnxIdrwiiVHrR^iSTi'Irdlri .ni: 


you c\\tV and 

p.lcs you Will fee able 

OU 七 1 c 七 Y ou j us 七⑽如 土 








I 




UHllTil 4 
lMta\ land iHJvm ! 
Lrii^l uIam IU 

Lslnri ElnMi-1n#l ■? Ltl 








UOje&iI 


3nsla-T*yM y„ i.fl 


IVn 


V?c vi 

Sunnyvale 

Sanla Ci^ra 


nn^ fooling. 




1 





What do you need to do now to get the data out of 
the picker and into your Twitter message? Think 
about the “Tweet it!” button press action and how 
that will need to change... 
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Use our picker reference to pull 
the selected values 


Now all that’s left is to use our reference to the picker to get 
the actual values Mike selects. We need to reimplement the 
sendBut ton Tapped method to pull the values from the 
picker. Looking at the UlPickerView documentation, the 
method we need is selectedRowInComponent:. That 
method returns a row value, which, just like before, we can 
use as an index into our arrays. 


l i- fov ouv ^ 

一 W 代它如 ㈣ Wat y 七 

^ /\ y\ _ ./A /\ . z / 


q Lca > «hd ( 

ouv . 





- (IBAction) sendButtonTapped : (id) sender 


NSString* themessage 
about it .〃， 


[NSString stringWithFormat : @ A m %@ and feeling %@ 


[activities objectAtlndex : [tweetPicker selectsdRowInComponent:0]], 
[feelings objectAtlndex : [tweetPicker selectedRowInComponent:1]]]; 
NSLog(themessage); / 

- Ni Q Ti^g ( ^ nppr^H I ,r \ 


Pull tWis loj message out fu-t m to see 

y/V^a-t -Pmal Tw’rbtev* message Will be. 


^ f Te'W NSSW S 如叫 L J 加 — s 

’二二 plated ^ ⑽ .^^ s ， 

stvmy, so viC U ^ 




InstatwitViewController.m 


We’re just going to log this message to the console so we car 
the string we’re building, and then we’ll send this to Twitter 

n i o +■ m 11 o T o dim -t a i o ^-^-1 -i 


can see 


me string we re ouiiaing, ana men we 11 sena mis tc 
just a minute. Let’s make sure we implemented this 

before twpptmcr tn tViP wVinlp wnrlH 


m 
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ready to tweet 



TesT DriVq 


OK, try it out. You should get a convincing tweet in the 
console: 



A ^ O 

二 InMdlml - 

—, j - 

- Debugger CginaijJki 



l , jiimyUior - J.. 

2k 、 



r ii 

Ownrmw 

BulktiMi G 9 > Tai.ii f^arnrC 

4cuv，h 

Clear Log | 


I^tl mi - 1 & t 3 i^tE |7 | 

i Hi-riTJirLT.] J IJ tldh\ | _ iiftlla uarUibg 

kfeppf ibou%. %%« 


.,LW tV>»S 

yjc 3 (i» \j 0 \Ar 

, a ▲卽一 d 


Bjscirnw 


11:30 AM 


Insla-Tv/!! v. t 


and IccAng 


rm 


Tei?Wg 


awesom 


shopping 


sad 


I leiiy tfVUf iUutyi! iidkjyy 




a^ctii 


K 


Thwei ir 


All tkat^s left is to talk to Twitter— 
we’ll kelp you witk tkat. 
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k 鄉 9 Baw 

■V 

0>pe 


To post to Twitter, we’re going to use their API. Rather than 
go into a Twitter API tutorial, we’ll give you the code you 
need to tweet the string. Type the code you see below into the 
InstatwitViewGontroller.m, just below the NSLog with the 
Twitter message in the sendButtonTapped method. 


\/ouv av>d yass^d 

//TWITTER BLACK MAGIC 厂 *to 50 m 

NSMutableURLRequest *theRequest^/[NSMutableURLRequest requestWithURL : [NSURL 
URLWithString:@"http: "YOUR—TW 工 TTER_USERNAME:YOUR_TWITTER_PASSWORD@twitter•com/ 
statuses/update.xml”] 

cachePolicy:NSURLRequestUseProtocoICachePolicy 
timeoutlnterval:6 0.0]; 

[theRequest setHTTPMethod: @’’POST’’]; 

[theRequest setHTTPBody : [[NSString stringWithFormat:@’’status=%@", 
themessage] dataUsingEncoding:NSASC 工工 StringEncoding]]; 

NSURLResponse* response; 

NSError* error; 

NSData* result = [NSURLConnection sendSynchronousRequest : theRequest 
returningResponse : &response error : &error]; 

NSLog ([ [ [NSString alloc] initWithData : result 
encoding:NSASC 工工 StringEncoding] autorelease]); 

// END TWITTER BLACK MAGIC 


If you don’t have a Twitter account, 
just go get one! 

Just go to twitter.com and register. Once 
you do that, you can enter your username 
and password, and this will work like a charm. 




InstatwitViewController.m 


After adding that code, you can just save, build and go. It will 
now show up on your Twitter feed. Go ahead, try it out! 
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miTce’s feeling great about your app 
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iPhonecposs 

Flex your vocab skills with this crossword. 



Across 

3. This typically handles the information itself in the app. 

6. This is the document Apple uses to evaluate apps for 
the App Store. 

7. You see this listed in the view and it controls the view. 

9. This component allows for controlled input from several 
selections. 

10. This type of app is typically one screen, and gives you the 
basics with minimal interaction. 

11. These define to which messages the datasource and 
delegate respond. 


Down 

1. This typically contains the logic that controls the flow of 
information in an app. 

2. The best way to figure out what protocols you need to worry 

about is to check the_. 

4. This app type typically involves hierarchical data. 

5. This app type is mostly custom controllers and graphics. 

8. The other name for an *.xib file. 
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more app types 


EiteticiSe 


We’ve listed a couple of descriptions of a some different 
apps. Using the app description, sketch out a rough view 
and answer the questions about each one. 



Generic giant button app 

There are several of these currently up for sale 
on the app store. This app consists of pushing 
a big button and getting some noise out of 
your iPhone. 


What type of app is this? 


What are the main concerns in the HIG 
about this app type? 




Book inventory app 

This app’s mission is to keep a list of the books 
in your library, along with a quick blurb of 
what it’s about and the author. 





What type of app is this? 


What are the main concerns in the HIG 
about this app type? 
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iPhonecposs Solution 

Flex your vocab skills with this crossword. 



Across 

3. This typically handles the information itself in the app. 
[DATASOURCE] 

6. This is the document apple uses to evaluate apps for the 
App Store. [HUMANINTERFACEGUIDE] 

7. You see this listed in the view and it controls the view. 
[FILESOWNER] 

9. This component allows for controlled input from several 
selections. [PICKER] 

10. This type of app is typically one screen, and gives you the 
basics with minimal interaction. [UTILITY] 

11. These define to which messages the datasource and 
delegate respond. [PROTOCOLS] 


Down 

1. This typically contains the logic that controls the flow of 
information in an app. [DELEGATE] 

2. The best way to figure out what protocols you need to worry 

about is to check the_. [DOCUMENTATION] 

4. This app type typically involves hierarchical data. 
[PRODUCTIVITY] 

5. This app type is mostly custom controllers and graphics. 
[IMMERSIVE] 

8. The other name for an *.xib file. [N 旧 FILE] 
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ExeRciSe 

§01ui|0H 


We’ve listed a couple of descriptions of a some different apps. 
Using the app description, sketch out a rough view and answer 
the questions about each one. 



Generic giant button app 

There are several of these currently up for sale 
on the app store. This app consists of pushing 
a big button and getting some noise out of 
your iPhone. 


What type of app is this? 


J\y\ immersive 


What are the main concerns in the HIG 
about this app type? 

The bij| Apple dares about is 七 
dorrtvols u p\rovidc m*tcv-r\ally dor\sis*tcr\*t 

experichde.” So everythin ddh be dus-tom, i*t 
r^ccds *bo -focused ar\d well or^ahiz^d. 




Book inventory app. 

This app’s mission is to keep a list of the books 
in your library, along with a quick blurb of 
what it’s about and the author. 


What type of app is this? 

A frodud*tivi*ty aff 

What are the main concerns in the HIG 
about this app type? 

The W\6j has mahy more spedi-fid rules dbou*b 
■this app -type, because you’ll be us*m^ s-ba^dard 
dorrbrols. EACH dorrbrol Y\ttds bo be Checked 
ou*t -for proper usd^e- 




I Some havigatioh s-tu-Pf heve 

/ 

t_ I 


i 1 

Book list I 







N 




A^oihc\r View (or details, ^ced io -figure 
oui how -to gei -fco it- 
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Your iPhone Toolbox 

You’ve got Chapter 2 under 
your belt and now you’ve 
added protocols, delegates, and 
datasources to your toolbox. For a 
complete list of tooltips in the book, 
go to http://www.headfirstlabs.com/ 
iphonedev. 






BULLET POINTS 


■ The picker needs a delegate and data- 
source to work. 

■ In a picker, each dial is a component. 


■ 


a 

咖 V 一抑 




In a picker, each item is a row. 

Protocols define the messages your class 
must realize—some of them might be 
optional. 


i mdvs 
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renee is getting suspicious 


This is /^ChCC, Mike 
9'^l4ichd 


s 


O 



Ifs so great that Mike and I are 
communicating now! But IVe noticed that 
Mikes starting to sound like he's in a rut, saying 
the same thing over and over again! Is there 
something we need to talk about? 



Sounds like Mike is going 
to need some modifications 
to InstaTwit to keep his 
relationship on solid ground. 
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3 object!Ve-c {or tKe !f]ione 


考 



% Twitter needs variety 


I know these are letters and 
all, but I have no idea what 
you re saying... 






% 


We did a lot in chapter 2, but what language was that? 

Parts of the code you’ve been writing might look familiar, but it’s time you got a sense of 
what’s really going on under the hood. The iPhone SDK comes with great tools that mean 
that you don’t need to write code for everything, but you can’t write entire apps without 
learning something about the underlying language, including properties, message passing, 
and memory management. Unless you work that out, all your apps will be just default 
widgets! And you want more than just widgets, right? 


this is a new chapter 


renee wants more 


Renee is catching oh"" 

Mike has been diligently using InstaTwit to communicate his feelings, but his 
girlfriend is starting to think something weird is going on. Even for Mike, who 
is a guy who likes his routines, his tweets are starting to sound suspicious. 


InstaTwit was working great, and is so easy to use! 
But I think Renee is on to me. She said I sound like 
rm in a rut. I need to be able to add to my tweets 
or this isn’t going to work much longer. 



We need to make some adjustments 
to our InstaTwit design. 

Take a look at the various Ul controls available in 
Interface Builder, and think about what would be a 
quick and easy way for Mike to add to his tweets. 
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objective-c for the iPhone 


Make room for custom input 


It’s nothing fancy, but Mike could add a little personal flavor to his 
tweets with a text field at the start. It means he’ll need to do some 


typing, but in the end his tweets will be more unique. 


s*tu« dovm a 







Code Magnets 

Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


O 

o 

o 

❹ 

o 


to InstatwitViewG ontroller. h. 

to the top of 

InstatwitViewG ontroller. m. 

to the dealloc in 
InstatwitViewG ontroller. m. 


using Interface Builder. 

to the property created in step 
#1, using Interface Builder. 



Add an IBOutlet and @property 
declaration for the UITextField 




Add an IBAction for 
the UITextField 
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Vi Design Magnets Solution 

Usina what vou know from addina the Dicker a 


Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


o 


Add an IBOutlet and @property 
declaration for the UITextField 


to InstatwitViewGontroller.h. 




ll 


IBOutlet UlPickerView *tweetPicker; 

IBOutlet UITextField *notesField; ^ - — . 1 

NsArray * activities 

NSArray* feelings; ^ ^ 3 4 ) add a 

} so UtrUt W 如妙、 

tall notesField- 

Qproperty (nonatomic, retain) UlPickerView* tweetPicker; 

©property (nonatomic, retain) UITextField* notesField; 




O 


Wait a minute. We keep adding 
code to this .h file, but I still don’t 
know what a .h file really does! 
What gives? 



InstatwitViewController.h 


A .h file is a header file. 

It’s where you declare the interface and methods for a class. All 
of the classes we’ve used so far, like UITextField, NS String, and 
NS Array, have header files you can look through. Take a minute to 
look through a couple and start thinking about what is happening 
in those files. 



Watcli it! 


Beware of private framework headers 

Sometimes you’ll come across a really 
tempting method that’s not defined in the Apple 
Documentation. Using undocumented APIs will 
get your app rejected from the iTunes store. 
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Header files describe the interface to your class 


In Objective-G, classes are defined with interfaces in the header file. It’s where you declare if your 
class inherits from anything, as well as your class’ fields, properties, and methods. 




@interface InstatwitViewController : 
UlViewController 


㈣ 工 


IBOutlet UlPickerView ^tweetPicker 



InstatwitViewController.h 


Sharp your pencil 


InstatwitViewController.m 


Here’s our current InstatwitViewController.h file. Fill in the 
blanks and explain what each line does. 



NSArray* feelings; 


Qproperty 



Qproperty 


(nonatomic, 

(nonatomic. 


retain) UlPickerView* tweetPicker; 
retain) UITextField* notesField; 


- (IBAction) sendButtonTapped : (id) sender; 

- (IBAction) textFieldDoneEditing:(id) sender; 

/ 

@end 



3 


InstatwitViewController.h 


you are here ► 


93 

































sharpef? solution 


Sharpen your pencil 
★V Solution 


Here’s our current InstatwitViewController.h file. Fill in the blanks 
and explain what each line does. 


#import <UIKit/UIKit.h> 


养 inr\po\rt 'mdo\rpo\ra*tcs another -file (almost always a headev 


-file) *m*to -this -file y/hch i*t’s Compiled. |*t’s used *bo pull m diasses ； 

| 七、 aUost •,actual k ^ ^ oi ^ r ^ ,lcs * 


广 


mdlud'm^ *b^c same 
-tWcs (so v\o wove 


养 vf 灼 dd 


r 




dass 






Objc^twc—C docsy\ *b suffo\r"t 
multiple ’mV^\r’rtai^e … 


&\v\it^au md'^ates >/ou v-c 
—M 仫 AttUrt a dlass. 

@interface 工 nstatwitViewController : Heres ou\r 'mhcriiahdes av\d *m*tc\r+adcs. 

UlViewController <UIPickerViewDataSource A 
UIPickerViewDelegate> 


Sis 




This is where y/c C^y\ declare -fields o-f our dlass. 


V, 


工 BOutlet UlPickerView *tweetPicker 
工 BOutlet UITextField *notesField 
NSArray* activities; 

NSArray* feelings; 




S|sr 


C++. 


咖 -to 


InstatwitViewController.h 
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^Sharpen your pencil 
^ Solution 


Oy\Cc you^ve closed -field sed*tioh o-f your you 

C^y\ declare properties. 沴 property tells Objcd*tive-C bo 
au*togchC\ra*tc getter a^d setter methods -for you. 


,These a 代 ^oYtrbl d 

talk move about t^ese 仏』 7 … 

@property (nonatomic, retain) UlPickerView* tweetPicker; 

Tk { , w a ^d "一 J 

丄 b 7 y 伽 “( 冲 ) • ，七 ㈣ 

wC ^ods. tkt\ass. 


@property (nonatomic, retain) UITextField* notesField; 





wC -tWs m Obje^we-C ave ? ubU- 


These av-c -the method dcdlav-a-tiohs. 


( 工 BAction) sendButtonTapped : (id) sender; 


-( 工 BAction) textFieldDoneEditing:(id) sender; 




^$£St 

events- 



IBA^tioh method sighatuv-cs must 

take 。於 avgumcht <^P type id, whidh 

is like a void * ih C++ OV- 0\)\cti 
\rc+C\rChdC ih Java. 


@end @cv\d ： c^ds your dlass 'm*ter-fadc dcdlara*tioh. 



InstatwitViewController.h 
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Design Magnets Solution (Continued) = : 士 J 


y/c 


wcv"C y/ov-k'mj 

Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


o 


Add an IBOutlet and @property 
declaration for the UITextField 


to InstatwitViewG ontroller.h. 



IBOutlet UITextField *notesField 

NSArray* activities; 

NSArray* feelings; 


Qproperty (nonatomic, retain) UlPickerView* tweetPicker; 

©property (nonatomic, retain) UITextField* notesField; 


to the top of 

InstatwitViewG ontroller.m. 



InstatwitViewController.h 


- 

一一 ^ w ―仏 already 


InstatwitViewController.m 


OK, so if we declared a property 
in the .h file, then adding ©synthesize 
in the .m file must auto-generate some 
code, right? 


o 


Yes! It generates the getter and setter methods. 

Using @property lets the compiler know we have a property, 
but that’s not enough. Using the @synthesize keyword in the 
implementation files, we can have the compiler auto-generate the 
setter and getter method we talked about earlier. The compiler will 
generate a getter, and, if it’s a readwrite property, a setter and 
implement it based on the @property attributes declared in the .h 
file. So what do the different @property attributes do...? 
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—— V^WCi 9 黾蕈舊 —— 

m 

Below is a list of the most commonly used property attributes and 
definitions. Match each attribute with its definition. 


recidonly 


W\\tY\ you pv-opcv-ty *to be modi-f iablc by 

people- The domfilcv- y/ill jc^c\ra*tc B yt*tcv- By\A B 
srbtev" -fov- you. This is -the dc-fault 


retain 


W\\tY\ youVc dedlih^ y/i*th bdsid -types, like -floa*ts ； 
The dompilev- jus-t ^\rca*tcs d srttev wrth a simple 
r^ypicld — value This is -the default bu 七 

^o*t usually v/ha*t you y/a^t 


recidwrite 


W\\cy\ you’ve wi*th object values. The dompilev- 

will vc*ta*m 七 he value you pass *m (well *talk more about 
\y\ d d^d release *thc old value ^i\\cy\ d 

Y\t^i oy\C domes m. 


cgpy 


you do / 七 v/arrt people rwodi-fy'm^ *thc pvopev-ty- 
You tBr\ s*till *thc f ield value *thc 

p\ropcv-ty, bu*t *thc 匕 ompilev* jc^cv-a*tc d setter. 


assign 


W\\tY\ you y/a^*t *bo hold ojrrto a dopy o( some value 
ms*tcad o( 七 he value i*tscl-fj -fov- c^a^plc, i-f you wa^*t 
*to hold oy\{jo by\ av-vay bv\A do^*t v/a^*t people h> be able 
*to i*b 乙 o 的 *tc 的 t a-ftev- -they sc*t it This sends a 

dopy message *bo value passed m *thc 的 \rc*ta*ms 
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who does what solution 








m 




Below is a list of the most commonly used property attributes and 
definitions. Match each attribute with its definition. 


recidonly 


retain 


recidwrite 


cgpy 


assign 



W\\tv\ you v /扣七 p\ropcv-ty *to be modi-fiablc by 
people. The dompilev- will jc^cv-a*tc a yttev- a 
sc*ttc\r -fov you. This is default 

iVhc^ youVc y/i*th \)Bs\t types, like -floats ； 

t\,C- The ^ompilcv- jus*t Creates a sc*t*tcv- wi*th d simple 
myFicldl — value This is de-fault ； bu*t 

y\o{, usually you 

W\\cy\ you’ve dcdli^ y/i*th olojc 匕 *t values. The dompilcv- 
y/ill vc*ta'm value you pass *m (y/e’ll talk move about 
\rctam*mg \y\ d mmutc) and \rdcasc *thc old value v/hc^ d 
^cv/ ov\C domes *m. 


you do^*t people modi-fymj *tiic p\ropc\rty. 
3 的 s*till *thc -field value ba^k'ma -the 


W\\CY\ 

You cby\ s*till -field value ba^k'm^ -the 

p\ropc\rty, bu*t *t^C ^ompilcv- v/oir /七 jc^cv-a*tc a setter. 


W\\tv\ you v/a^*t *to hold oy\{x> 3 dopy <y( some value 
'mstcad o-f *thc value i*tscl-f; -fov- example, i-f you y/a^*t 
*to hold or\h> av-v-ay do〆 七 v/a^*t people -to be able 

*to i'ts do^*tc^*ts a-f*tcv- -they sc*t it This se^ds a 

dopy rwcssa^c *to *t^c value passed'm *thc^ v-c*ta*ms 


thereiare no o 

Dumb Questi 9 ns 


How does the compiler know what field to use to hold the 
property value? 

By default, the compiler assumes the property name is the 
same as the field name. In reality, it doesn’t have to be. You can 
specify the field to use to back a property when you @synthesize it 
like this: @synthesize secretString=_superSecretField;. 


What about that nonatomic keyword? 

By default, generated accessors are multithread safe and use 
mutexes when changing a property value. These are considered 
atomic. However, if your class isn’t being used by multiple threads, 
that’s a waste. You can tell the compiler to skip the whole mutex thing 
by declaring your property as nonatomic. 
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Auto-gcwcrated accessors also handle memory 
management 


Objective-G on the iPhone doesn’t have a garbage collector, so you have to use reference counting. 
That involves keeping up with how many references there are to an object, and only freeing it up 
when the count drops to zero (it’s no longer being used). When you use properties, the compiler 
handles it for us. The properties we’ve declared so far have all used the retain attribute. When the 
compiler generates a setter for that property, it will properly handle memory management for us, 


like this: 




y\o 






Qproperty (nonatomic, retain) NSString* secretString; 
Qsynthesize secretstring 







- (NSString*) secretstring - 
return secretString; 


威 ㈣ 




ak a 


- (void) setSecretString : (NSString*) newValue { 
if (newValue != secretstring) { 

[secretstring release]; 
secretstring = [newValue retain]; 




S ' 必一 d = 

abated sett ^ ^ ^ docs 

a 代 \case ⑽咖 0 
撕咖 w 喊 


Sharpen your pencil 


Write the code that Objective-C generates for each property 
declaration below. 


Qproperty (nonatomic, readonly) NSString* myField 


2. Qproperty (nonatomic, retain) NSString* myField 


3. @property (nonatomic, assign) NSString* myField 
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sharpen solution 


i^Sbarp your pencil 
i < Solution 


Below is the code that the compiler will generate for each 
property. 


1. @property (nonatomic, readonly) NSString* myField 

- （/ V ££* brm 3 决） nr \ yF*idd { 

\rc*tu\rh myPicldj 

} 

2. @property (nonatomic, retain) NSString* myField 

- myField { 

\rrtu\rh r^yPicldi 

} 

- (void) sc*tMyP«cld ： (hl££br\v\^) 

hcw\/alue { 

i-f (heWalue l—myFidd) { 

CmyPield release]; 

myField =■ Chcw\/aluc v-c*ta*m 3 ; 

} 

} 


3. Qproperty (nonatomic, assign) NSString* myField 


(NSS'brm^O myField { 
return mypicld; 


(void) sc*tMyPicld ： (NSS*t\r'm^) ^ew\/aluc 


Be ^e-ful with this o, C ... /VSSVmas & 

ltrT '7 ied 吟也 s 。 “il Ahis 

woirk, having dS sia h 

^ ah is ^ ob ^'y ^ 


} 


myField =■ hcw\/aluc ； 


aUost always you 
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O 


I bet that release just lets go of 
the memory that your properties 
use up, right? 



Objcctive-C can automatically release references, too. 

In addition to retain and release, Objective-G has the concept of an 
autorelease pool. This is basically an array of objects that the runtime 
will call release on after it’s finished processing the current event. To put 
something in the autorelease pool, you simply send it the autorelease 
message: 

[aString autorelease]; 

It will still have the same retain count, but after the current event loop 
finishes, it will be sent a release. You won’t want to use this all the time 
because it’s not nearly as efficient and has some performance overhead. It’s 
not a bad thing to use, but it’s better to explicitly retain and release when 
you can. 


To keep your memory straight you heed to 


remember just two things 




Memory management can get pretty hairy in larger apps, so Apple has a couple of 
rules established to keep track of who’s in charge of releasing and retaining when. 



You must release objects you create with alloc, new, copy, or mutableCopy. 

If you create an object with alloc, new, copy, or mutableCopy, it will have a retain count of 1 
and you’re responsible for sending a release when you’re done with the object. You can also 
put the object in the autorelease pool if you want the system to handle sending a release later. 



Consider everything else to have a retain count of 1 and in the autorelease 
pool. 

If you get an object by any other means (string formatters, array initializers, etc.) you should 
treat the object as having a retain count of 1 and put it in the autorelease pool. This means 
that if you want to hang onto that object outside of the method that got the object, you’ll 
need to send it a retain (and a corresponding release later). 
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memory management up close 



JV[etnary JV[anagetnent Up Cl^se 


This is some o( -the rwemov-y 
rwa^ajcrwcht toAt tha-t Y^W 

have dl\reddy wvitte 灼 / 


一 (void) dealloc { 

[tweetPicker release] 
[activities release ]； 
[feelings release ]； 


[super dealloc ]； 


Memory management is definitely important on iPhone, but that doesn’t mean it’s 
complicated. Once you get the hang of a few key principles, you’ll be able to structure 
your app so that it doesn’t leak memory and get you kicked out of the app store. 

When you create an object, it starts with a count of 1, and different things you do can 
raise and lower the count. When the count reaches 0, the object is released and the 
memory is made available. 


If 



QWt 
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Determine how many references are left at the end of the chunk of code and if 
we have to send it a release for each string. 

Final Reference Count 


NSString *first = [[NSString alloc] init]; 


NSString ^second = [[NSString alloc] init]; 
[someStringArray addObject : second]; 


NSString *third = [[NSString alloc] init]; 
[third autorelease]; 


NSString ^fourth = [NSString 

stringWithFormat:@"Do not read %@", Swimming 
with your iPhone by TuMuch Monee"]; 


NSMutableArray ^newArray = [[NSMutableArray alloc] init]; 

NSString *fifth = [[NSString alloc] 
initWithFormat: @"Read this instead : %@〃，''Financing your 
iPhone 4G by Cerius Savar’’]; 

[newArray addObject:fifth]; 

[newArray release]; 


NSString *sixth = [NSString stringWithString:@”Toughie〃]; 

NSArray ^anotherArray = [NSArray 
arrayWithObjects : sixth count:1]; 

NSDictionary *newDictionary = [NSDietionary 
dictionaryWithObjects : sixth forKeys : @ 〃 Toughie 〃 

count:1]; 

NSString *ignoreMe = [sixth retain]; 
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keeping count 


At 


Ex^ficiSe 


Determine how many references are left at the end of the chunk of code and if 
we have to send it a release for each string. 

Final Count 


NSString *first = [[NSString alloc] init]; 


Rc-fcrchde douh*t will be I 
because allod automatically sc*ts 
dour\*t *to I. 


NSString ^second = [[NSString alloc] init]; 
[someStringArray addObj ect : second]; 


w sedor\d" will have d dourrt of 

Z *this blodk o-f Code I -fvom 

■the dllod) I -from *msc\rtm5 i*t *m*to *thc 

Z avvay. /Ways au-toma-ti^ally rc-tam 
•rtems added bo *thcr^. 


NSString *third = [[NSString alloc] init]; 
[third autorelease]; 


This still hds a rc*ta*m douh*t o-f I 
because *the dllod ； bu*t is how m 
■the autov-clcasc pool, i*t v/ill 

be scr\*t a release au*toma*tidally a-f-tcr 

*thc du\r\rCh*t loop hds Completed* 


NSString ^fourth = [NSString 

stringWithFormat:@〃Do not read %@〃， @^Swimming 
with your iPhone by TuMuch Monee〃]; 


This will have d vc*ta*m douh*t of I, 
bu*t will be \v\ *the au*tov~elease pool 

because we didr/ 七 i*t via allod, 

r\cw, dopy, or mu-t^blcCopy. 
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Determine how many references are left at the end of the chunk of code and if 
we have to send it a release for each string. 

Final Count 

will have a v-rta'm dou^-t I- 


NSMutableArray ^newArray = [[NSMutableArray 
alloc] init]; 

NSString *fifth = [[NSString alloc] 
initWithFormat:@〃Read this instead : %@〃， 
''Financing your iPhone 4G by Cerius Savar’’]; 

[newArray addObj ect : fifth]; 

[newArray release]; 


NSString *sixth = [NSString 
stringWithString : @ 〃 Toughie〃]; 

NSArray *anotherArray = [NSArray 
arrayWithObjects : sixth count:1]; 

NSDictionary ^newDictionary = 
[NSDictionary dictionaryWithObjects : sixth 
forKeys:@ 〃 Toughie 〃 count:1]; 

NSString *ignoreMe = [sixth retain]; 


Pi\rs*t i*t yb a rc*ta'm douh*t o-f I -fvom 
{\\t allod. 

i*t ^oes *bo Z because i*t’s msc\rtcd 

•m*to 

Ther\ i*t goes ba^k -to I because array 
will stY\d a release *to all o-f its i*tems 
whch -the array is dcs-troycd. 

w si>cth" s*ta\rb ou*t >wi*th du*bo\rdedsed vc*ta*m 
douh*t o-f I -from i*t 

was^-t -fvom allod, so i*t’s au*to\relcased). 

hU 此 a^o-thcr return -from mscvtmj i*t m*to 
array, hloie -the array 七 allowed either, so 
i*t will be au*to\releascd, -boo. 

Thcr\ or\C more rc*ta*m -fvom *thc didiohary, also 
r\o*t allowed dhd y/ill be au*bordcased. 

Pmally, e%plidi*t 

So, cvch -though w si>cth” has d rc*t3*m douh*t o-f 
y/c, the dcvclopcvs, or\ly v\tcd *to send or\c release 
bo u si%*th w and lc*t cvev-y*th*m^ else dleah up wi*th 
{ht autorclcasc pool. 
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magnets solution 



Design Magnets Solution (Continued) 

Using what you know from adding the picker and the button, match the 
magnet with the method or file that you’ll need to edit to add the text field. 


o 


Add an IBOutlet and ©property 
declaration for the UITextField 


to InstatwitViewG ontroller. h. 



InstatwitViewController.h 


to the top of 

InstatwitViewGontroller.m. 


InstatwitViewController.m 


o 


Add [notesfield release] 


to the dealloc in 
InstatwitViewGontroller.m. 


(void)dealloc { 

[tweetPicker release]; 
[activities release]; 
[feelings release]; 

[notesField release]; 

[super dealloc]; 


SSS2. 






Create 
datasource 


Wic dcm ’ 七 

a^*t>or\ o\r d 

-for v\oits -f ield- 

Add an IBAction for 
the UITextField 

delega 


a 


for 


the notes 


Field 
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o 


Add UITextField 

to the view 


using Interface Builder. 


To get into this, you’ll need to open up InstatwitViewGontroller.xib and find the text field in 
the library. Then drag and drop the text field in between the “InstaTwit” label and the “I’m 
.... and feeling ...” labels. You’ll also need to put a label that says “Notes” in front of the text 
field. 


labels, WtW do^ 
a little- 





LUj 

_ ■ Nfc/_ _■ 

hgeni 1 filled『animl Phipl 钃 『h 

rruTiipM tegrruMs, iuh -gf lArh^h 
hinHJtmE as a HiHlrrli buttiM. 

Lalwl 

Lifeh-H - A vwkiMt s-iz-fid Bm^ynt 

H jIJi Lei/L 


Rmund fL-prl itulEEm > ln£pi-i I|nprh 

r^vnii iAd vM\ m mf f 

1 U/Q4C Dt^tCE ¥Hh4-fl fTs upped. 

、 Tp*1 ^ 

l«iL Mild - CPrapU^ ciTi p .jlik Eiwt jthJ 
>cr^h Jctipii mr^u^r m 

wK*fi Rrnjm 1$ uptH. 

n ] 

bvHtcii - Kipt jyi <rtcffmVt shMinf 

llw bugiun laLdv pi 1 hIu«. Aikwi 
rjHiina itu fanir_ ■ ， in^glr ihr- ■idluf 

善 

■ ChipU^s a coirlmMUi rvrpt 


o 





Link the UITextField 
to the IBOutlet 


hkvUSwi(Vi^rviCE 3 nEr^lltr.jiil? 


T 


fi™ Rc-Epondir 
mtik 
Igl 

label IfU 
Litel 

I mhrl fjfHiul iE ] 

RQUmdEli KHE KUEIWI ttWHl [in 
lj|>ci 加 9I4 ， T_ V. |.<l|i 
iBUirui Srylf Tfii ritl_ 

4»abil i%J^I 



TV” 


Im Lj EwtfVI ia 相 ru 11 e I 


LHVI#« 


to the property created in step 
#1, using Interface Builder. 

o, Fil^s Ow.e, a ,d 
^ dc ^ io 

h °t' sF，c,d W/TcxiFicId 

the view. 


UhLkvrViq 

UUfi4l 


fo 

-f Ouclti^ 

MVe ChiTHr 


Si 

1 rvMiiri#ftd 

i«uiJiDnp4ivCvrlre 

■ baued levy T#i r f mM 


i 

ftw 

0 





Save it anct tken ••• 
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test drive 



Tesr DriVq 


Now that everything is saved, go back into Xcode and build and run, and 
launch the simulator. 



I 


Cl'»6k *to 
v/v»*bc a *to 
dustow， 2 ^ 

七 wcc 七 …. 


2A^ PM 


In 邮 -Ttvil. k 

■ 1 。 I 

NqIds: 

I'm 


： irk1 Mng... I 


sad 


I 


about iE. 


It works! 



IJl5la-TWil 




tpehrkg 


^ d，dh 

V,avc do 
^ make k^board 

ud fov *b^c 






十 i 中 I 巾 H 抑 
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objective-c for the iPhone 



OkjcctWc-C 

This week’s interview: 

Who are you anyway? 


Head First ： Hello Objective-G! Thanks for coming. 

Objective-C: Thanks! It’s great to be here. I’ve 
been getting a lot of attention recently with this 
whole iPhone thing. 

Head First ： So you have a pretty strong lineage, 
right? Why don’t you tell us a little about yourself? 

Objective-C: Sure. I’m an Object Oriented 
language, so I have classes and objects, but I come 
from strong G roots. My OO concepts come from 
Smalltalk. Really, there’s not much to me. 

Head First ： What do you mean you come from G 
roots? 

Objective-C: Well, nearly all of my syntax is just 
like G syntax. For loops, types, pointers, etc. You 
can easily use other G libraries like SQLite with me. 
Things like that. 

Head First ： But you’re more than just that, right? 

Objective-C ： Oh yeah, definitely. Most obviously, 

I am an OO language, so classes, abstract interfaces 
(which I call protocols), inheritance, etc. all work 
great. 

Head First ： So what about memory management? 
Malloc and free like G? 

Objective-C: Well, malloc and free work just 
like they do in G, but I have a really nice memory 
management model for objects. I use reference 
counting. 

Head First ： Ah — so you keep track of who’s using 
what? 

Objective-C ： Yup. If you want to keep an 


object around, you just tell me you want to retain 
a reference to it. Done with it? Just release your 
reference. When there aren’t any references left I’ll 
clean up the object and free up the memory for you. 

Head First ： Nice. Any other tricks? 

Objective-C ： Oh yeah. You know those getter 
and setter methods you need to write for other OO 
languages to wrap fields in a class? Not here. I can 
automatically generate them for you. Not only that, 
you can tell me how you want to handle the memory 
associated with them. Oh, and one of my favorites: 

I can graft new methods onto classes without a 
problem. They’re called categories. 

Head First ： Oh, that’s slick. We’re about out of 
time, so just one more question. What’s up with all 
those “NSs” all over the place, like NS String and 
NSInteger? 

Objective-C: Ah — those are all part of the 
GocoaTouch framework. I mentioned my strong 
lineage earlier; most of the core classes that people 
use on iPhone come from GocoaTouch, which 
is a port of Cocoa which came from OpenStep, 
which came from NeXTStep, and that’s where 
the NS comes from. The frameworks are written 
in Objective-G, but they’re frameworks, not really 
language things. When you write for iPhone, you’ll 
be using things like that all of the time. For example, 
instead of using charts for strings, you usually use 
NS Strings or NSMutable Strings. We all kind of blur 
together. 

Head First ： This is great information! Thanks 
again for coming by, and best of luck with the iPhone! 

Objective-C ： No problem. Thanks for having me. 
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no dumb questions 


What happens if I don’t retain an 
object I’ll need later? 

Most likely the object’s retain count 
will hit 0 and it will be cleaned up before you 
get to use it. This will crash your application. 
Now here’s the sad part: it might not crash 
your object on the simulator every time. The 
simulator has a lot more memory to work 
with and behaves differently than a real 
iPhone or iPod Touch. Everything might look 
great until you put it on your phone to test it. 
Then sadness ensues. 

What if I release my object too 
many times? 

Basically the same thing. When the 
reference count hits 0, the object will be 
released and memory will be freed. Sending 
that now-freed memory another release 
message will almost certainly crash your 
application. 

What if my project works on the 
simulator and dies on the real phone? 
Could that be a memory problem? 

Absolutely. Memory on a real device 
is much tighter than on the simulator. Well 
talk more about debugging these and using 
Instruments to track memory usage and 
leaks in a later chapter. 

How can I check if I’m managing 
my memory effectively? 

The iPhone SDK comes with a 
great memory tool called Instruments that 
can show you how your memory is being 
used, peak memory usage, how fast your 
allocating and deallocating it, and possibly 
most importantly, if you’re leaking memory. 
Well talk about it in detail later in the book. 


theretare no ^ 

Dumb Questions 

What happens if I set things to nil? 

Well, it depends on what you're setting 
to nil. If it's just a local variable, nothing. The 
variable is now nil, but the memory for the 
object it used to point to is still allocated and 
you've almost certainly leaked something. 
Now, if it's a property... 

Do I have to retain things I want to 
set on my properties? 

No! Well, probably not. That’s what 
the “retain” parameter is on the @property 
declaration. If you put retain there the 
property will automatically send values 
retains and releases when the property is 
set or cleared. Be careful about clearing 
properties in your dealloc, though. If you 
have a property with a retain parameter 
and it still has a value when your object is 
released, then whatever that property is set 
to hasn’t been freed. You can either send the 
field an explict release in your dealloc or set 
the property to nil. 

One more quick note: the automatic retain/ 
release ability of properties only works if you 
use the notation. If you explicitly modify 
the field that backs the property, there’s 
nothing the property can do about it and 
can’t retain/release correctly. 

Doesn’t Objective-C have garbage 
collection like Java or .NET? 

Actually, on the Mac it does. Apple 
didn’t provide garbage collection on iPhone 
OS however, so you need to fallback to 
reference counting with retain and release. 

What about malloc and free? Can I 
still use them? 


Yes, but not for object types. Malloc 
and free work fine for basic blocks of 
memory as they do in C, but use alloc to 
instantiate classes. 

What’s with that init call that you 
always put after the alloc? 

Objective-C doesn’t have constructors 
like other Object Oriented languages do. 
Instead, by convention, you can provide one 
or more init methods. You should always call 
init on any class you allocate, so you almost 
always see them together as [[SomeClass 
alloc] init]. 

How do I know if something retains 
my object, like an array or something? 

Basically you shouldn't care. Follow 
the memory rules that say if you got it from 
alloc, new, copy, or mutableCopy, you have 
to send it a release. Otherwise, retain/ 
release it if you ant to use it later. Beyond 
that, let the other classes handle their own 
memory management. 

Can’t we just append the message 
to the string? 

NSStrings are immutable, but we could 
with NSMutableString. 
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Put whew Mike's finished typiwg... 


The textReld works great, 
but how do I get the 
keyboard to go away? 


The keyboard is permanent? 

Go ahead, play with it and try to get the keyboard to go away. 
Return won’t do it, and neither will clicking anywhere else on the 
screen. Not so cool. 


BE . arcfilfecf 

Your job is to he ike arcliitect and plan 
how ike \eybo^vd needs to behave. Till 
inAe pattern diagram below to 

wiM needs to happen to 
make it away! 





_ should the use ^ see ? 


docs ihc view 

^oll c , hccd ^ 
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be the architect solution 



BE 驳 咖 ㈣ s©Jug©ti 

Your job is to be arcliitect and plan how 
tire \eybo^vd needs to behave. Till in tire 
pattern diagram below to explain ^iiat 

needs to happen to make it 
away! 





The user heeds *to 
uhdcvstahd wha*t to do 
■to make -the keyboard 
av/ay, so -the 

u \rc*tu\rr\ W button *to say 

U I » 

(Xotit - 



This ^ J r 

3 h 3 to show up j// 5 0 你一 <3hd 


ihere^ctre no ^ 

Dumb QuestiQns 


The view dorrbrollev 
heeds to Ytttwit *the 
w dor\c w i^css3^c dhd 
make -the keyboard 
away. 



c 


Co^vc^oy^s l«kc us‘>y^ 

'dU，*to leU^ us 吖 

W.dc kcvboard ar. 

d •祕 cd •… 

T\strt avc lots more ； 
iK Ao^t *«s just oy^c <A 

七 


Why didn’t we have to do anything to make the keyboard 
appear in the first place? 

When the users indicate they want to interact with 
a specific control, iPhoneOS gives that control focus and 
sets it to be the “first responder” to events. When certain 
controls become the first responder, they trigger the 
keyboard to show automatically. 


Let’s start witk tke view. 
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Customize your UlTcxtFiGld 


In Interface Builder, select Mike’s custom field and §€ 1 to bring up 
the inspector. You can specify an initial value of the text in the field 
(Text), text that the field shows in grey if there’s no other text to display 
(Placeholder), left, center, or right Alignment, the Borders can be 
different, etc. For now you don’t need to add anything for field, so leave 
these blank. 


Next change the label on the return key 

Changing the name of the button in the keyboard (so it’s “done” 
instead of the “return”）is another option in the inspector. The big 
thing that changing the label on the button brings to the table is that it 
clearly communicates to the user what to do to make they keyboard go 
away. 

Click on the Return Key popup menu and pick Done. 




v/a^*bcd *to* 



Watch out for the HIG! 

Beyond the Text and Placeholder fields, 
changing some of the other options may hurt 
your usability and make Apple unhappy, so 



s DcTjult 


nrfjhulf 


L^Nlllol 


a^d o^evs art woyrC 


I hi«ld Act^bylci 


T tfkiu Rlld 


■ ext 


Bender 


BufCnn 


CNev When EdiEinq l«lni 




Text Inpin 1 mis 


Kickgreund! 


DFidblffd 


Fonl 


rnnl 


Ad^iiiE Tn F^r 17 


Min S\it 


Appf-aranfr 


^ ^urf 


1 ?. 0 




OprictU^n 





Nont 

- 1 





De r^ult 


Rrhjrn Kf-y Drt^ult 


be careful. 


Now, get tke keytoarct to talk to tke view controller... 
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message passing 


Components that use the keyboard ask it to appear... 

When users click in the text field, iPhone OS gives that control focus and assigns it as “first 
responder” to that click event. A component can get focus a number of ways: the users explicitly 
tap on the control, the keyboard is set up so that the Return key moves to the next control they 
should fill out, the application sets some control to explicitly become first responder because 
of some event, etc. What a component does when it becomes the first responder varies by 
component, however; for a UITextField, it asks iPhoneOS to display the keyboard. All this 
chatter between the application and components is fundamental to writing an application, and it 
all happens through message passing. 


•••by passing messages to other objects 

The idea is that whenever one object (whether that object is your ApplicationDelegate, another 
component, or the GPS in the iPhone) wants some other object to do something, it sends it a 
message. 





oy\C objcd*t *to 匕 ommimi 匕 

a^o*thcv- object i*t sc^ds i*t d message- 



[activities objectAtlndex:row] 




3 






message {o 



@"sleeping 



/Wdh 七 vesfo^ds -to ^ cssa 3 c 
value • 


In Objective-G you send a message to an object and it responds to that message (as opposed to returning 
a value from a method). The Objective-G runtime turns those messages into method calls on 
objects or classes (in the case of static methods), but get used to thinking about these as messages; 
you’ll see things like “the receiver of this message will...” all over Apple’s documentation. Now ， 
let’s use message passing to get rid of the keyboard when the user is done with it. 


114 Chapter 3 



objective-c for the iPhone 


Ask the textFidd to give up focus 

In order to get the keyboard to go away, we need to tell the text field that the user is done 
with it. We do this by asking the textfield to resign its first responder status. 


Sending messages in Objective-G is easy: you list the receiver of the message, the message 
to send, and any arguments you need to pass along. 


r 

s T d 、 ^ [notesField resignFirstResponder. 


^ |ik c 


This is the -poir ihc messaae 

m ouv * ^ the ho-tcsFidd. 


TWis is y/V)c\rc you \>ut actual message, k 
ouv- cast wc V^avc v\o so «s all 

y/C r^ccd. See h\t dotiAmcyrtatio^ -tov 
details cm y/V^a-t messages eaA (^ 个❹七 
will \TCSfo\r\d {fi¬ 



ls that how the View is sending the 
View Controller information? 



Yes! Our View Controller can respond to a 
number of messages like sendButtonTapped 
and viewDidLoad. 

You’ve been responding to messages all this time. Now here’s the 
trick: the textField can send a message when the user taps the 
Done button on they keyboard. We just need to tell it that our 
ViewGontroller is interested in knowing when that happens. 



You can pass messages to nil with no obvious problems. 

Objective-C lets you send messages to nil without complaining. If you’re used 
to NullPointerExceptions from other languages, this can make debugging 
tricky. Be careful of uninitialized variables or nil values coming back as other nil 
values when you debug. 
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Hanging Messages Up Cl^se - 

You’ve been handling messages since Chapter 1, but we really haven’t talked about 
the syntax to make it work. Method declarations go in your header files and the 
implementation goes in the .m. Here are some snippets from our sendButtonTapped 
implementation from InstaTwit. 






@implementation InstatwitViewController 


rou 


m ? a^cs\s V>cW 
message ^ames. 


»S tailed a 

:uC ov rn 0 \>yC 

1 叫 ad dcsdvM^Wc. 


(v/rth 
sclctW 


\p ahd 


^ 七 hire fve airgumchts -to youv 

follow ^ r,«sa 9 e 

with a to\oy\, then -the -type 
fd o-f -the \oe,a\ vdHable. 

严邮。以 9 et 

戈 p«, ahd variable ham« ; W 


Ncv/ method Code hc\rc- 


( 工 BAction)sendButtonTapped: (id) sender 

Wc 山 W 0 {七 ^ 


工 


The ({ L . — , 


•^Whs 


TV svy^ta^ for dctla/m^ a ^cssay 
ma header ^»le .s -bV.c sa^c as m tV)c 



InstatwitViewController.m 
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Messages m Objective - C use named arguments 


In Objective-G, message names tend to be long and descriptive. This really starts to make sense 
when you see arguments tacked on. When you send a message with arguments, the message and 
argument names are all specified. Objective-G messages read more like sentences. Let’s look at a 
method declaration from UIPickerViewDataSource. This method returns the number of rows for a 


given component in a picker view. It’s declared like this: 

^ T 

- (NSInteger)pickerView:(UlPickerView 
owsInComponent:(NSInteger)component; 


Uo6a\ 


灼 awe 



*)pickerView 


Type J sc^ohdT" 

扣士 -y 


Lo ^l o( ^ 

冰 0hd 




numberOfR 




Methods can have internal and external names for arguments; the external name is used when 
sending the message to the receiver. So when iPhoneOS wants to send this message to our delegate, 
it creates a call like this: 


[pickerDelegate 


Message 




pickerView : somePicker 


a， …七 gttor^A 

J vdlvAC 

numberOfRowsInComponent:component]; 



thereicire no ^ 

Dumb Questions 


You keep switching terms back and 
forth between methods and messages. 
Which is it? 

Both are correct, depending on 
your context. In Objective-C, you send 
messages to objects and they respond. The 
Objective-C runtime turns your message 
into a method call, which returns a value. 

So, generally you talk about sending 
some receiver a message, but if you’re 
implementing what it does in response, 
you’re implementing a method. 


So about those arguments to 
methods ... what’s the deal with the name 
before the colon and the one after the 
type? 

In Objective-C you can have a public 
name and a local name for arguments. The 
public name becomes part of the selector <c 
when someone wants to send that message 
to your object. That’s the name before the 
colon. The name after the type is the local 
variable; this is the name of the variable that 
holds the value. In Objective-C they don’t 
have to be the same, so you can use a nice 


friendly public name for people when they 
use your class and a convenient local name 
in your code. 

One more interesting fact: the public name 
is optional. If you don't provide one, people 
just use a colon and the argument value 
when sending the message to your object. 
Obviously, the argument order is critical. 


Mov-c oy\ sclc^-tov-s m d m’mu 七 e. 
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message to controller 


Use message passing to tell our view 
cowtrollcr when the Pone button is pressed 

The text field can tell our ViewGontroller when the Done button was 
pressed on the keyboard; we just need to tell it what message to send. We 
can do this with Interface Builder. You’ll need to declare an action in both 
the .h and and implement it in the .m file: 





Messages jo'mj 
\\crt beWen 

dor\*tv-ollcv-. 


o 


Add the IB Action to InstatwitViewControl ler. h. 

Just like we did with the “Tweet it’’ button, go back into Xcode and add this: 

丁 he 



SB? s 





Hcvcs ^ atW. 丁^ 一 sa V! 


•rt’s an 

tteves the ^ j' iL+f-,cldPonctd'>t^5, 


InstatwitViewController.h 


Add the method implementation in InstatwitViewControl ler. m. 

Now that we have an action that will be called when the Done button is pressed, we just 
need to ask the textField to resign its first responder status and it will hide the keyboard. 


Smdc sender is i\\c 
W|Tc% 七 Beld, wc 6 釙 sc^d 
i\)t V-Cs'i^F'»\rs*tRcsfoir\dc\r 

batk -to it 



TV.C sedev a 

UlTc^f^ld. 


InstatwitViewController.m 


Almost tkere, we just need to wire it up •“ 
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^ Connect the UITextField event in Interface Builder 

Now the actions are declared，go back into Interface Builder by double 
clicking on InstatwitViewGontroller.xib. If you right-click on the 
UITextField you’ll bring up the connections. 




Imldlwil ViswC^tiI rglhr.3cll7 





In the list of events that the UITextField can send 
choose the “Did End on Exit” event and connect 
it to the File’s Owner’s 4; textF ieldD one Editing 
action we just created. 



Bits 


The UITextField has a number of events that it can raise, just like 
the round rectangular button. Take a second and check out the 
list that’s there. Along with the customizing that you can do in 
the Inspector with the field, you can wire up different (or even 
multiple!) responses to interaction with the field. Keep it in mind 
for your own apps. 
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no dumb questions 


tJiereiare no ^ 

Dumb Questi9ns 


Why did we send the message back 
to the sender in our action and not to our 
notesField property? 

Either one would work fine; they're 
both references to the same object. We used 
the sender argument because it would work 
regardless of whether we had a property that 
was a reference to our UlTextField. 

You mentioned selectors, but I’m 
still fuzzy on what they are. 

Selectors are unique names for 
methods when Objective-C translates a 
message into an actual method call. It's 
basically the method name and the names 
of the arguments separated by colons. For 
instance, the code on page 66 is using 


the selector pickerView : numberO 
fRowsInComponent. You’ll see them 
show up again in later chapters when we do 
more interface connecting in code. For now, 
Interface Builder is handling it for us. 

When we send the 

resignFirstResponder message to sender, 
the sender type is “id”. How does that 
work? 

“id” is an Objective-C type that can 
point to any Objective-C object. It’s like 
a void* in C++. Since Objective-C is a 
dynamically typed language, it’s perfectly 
ok with sending messages to an object of 
type “id”. It will figure out at runtime whether 
or not the object can actually respond to the 
message. 


What happens if an object can’t 
respond to a message? 

You'll get an exception. This is the 
reason you should use strongly typed 
variables whenever possible. However, there 
are times when generic typing makes a lot 
of sense, such as callback methods when 
the sender could be any number of different 
objects. 

So seriously, brackets for message 
passing? 

Yes. And indexing arrays. We all just 
have to deal with it. 


BULLET POINTS - 

■ In Objective-C you send messages 
to receivers. The runtime maps 
these to method calls. 

■ Method declarations go in the 
header (.h) file after the closing 
brace of an interface. 

■ Method implementations go in the 
implementation (.m) file between 
the ©implementation and the @ 
end. 


Method arguments are usually 
named, and those names are used 
when sending a message. 

Arguments can have an internal 
and external name. 

Use a to indicate an instance 
method; use “+” to indicate a static 
method. 
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Tesr DriVq 



B .»iS Carrtw 


11139 AM 


I nsta- Twit v. 1.0 


i fWer 


NnEes : 


and 


thin king 


1 


^|UF ■ Cr - 1 




Q W E RlT|Y|U 

-— * 1 J ■面 \一 i 


[kuniB 


.?123 


space 


It works! Tire keyboard 
goes away and you can play 
arounct witk tke text field 
anct actct some notes now. 


/-P you have you\r aUo^t 
ih -the Code, 

广 — cvcvy you 

Wt it anally will/ 


7a^ w dov\c 

WbW … 
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custom note is missing 


Something's still wot right 

Mike’s ready to try out the custom field and see what happens, but when he puts 
in his custom message... 







The custom note doesn't 
do anything! Ifs not 
showing up on Twitter. 


You can lix tkis witk no 
problem now tkat you’ve 
gotten tke kang[ ol events 
anct message passing [•“ 


JmM m \ □ 




Hk c 

Sc ^ds <9 

^cci. 




Uilriklrvii 


O W E R 


□□□□□□□□□ 




"o ^us-torn i h 4 
dll... 
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BE . 驳相 ecf 

Your job is to be arcliitect and figure out 
how tire TllTextReld and tire Tweet button 
need to worl^ togetiier using tire View- 

View Controller model. 
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build the tweet 


BE th^ 故相 ecf s©]ug©n 

Your job is to he arcliiteet and figure out 
how tire TJlTextReld and tire Tweet button 
need to worl^ to^eSxev using tire View- 

View CoitfPoller model. 




View 


I. Show -typed 

2*. Commur\id3*tc 
button push 





.Respond to bu*t*boh-*tappcd message 
2*. *the -fv-om *thc view 
冬 . Update 七 he da*tasou\rdc y/i-th *thc 七亡此 


Wild the tweet with strings 


We need to incorporate the note text into our tweet. In order to do that, we’re going to do a little string 
manipulation with the core string classes. You’ve already built a message to send to Twitter, but this time we have 
more text to include. Before you refactor the code to send the tweet with the new text in it, let’s take a closer look 
at what you did in Chapter 2: T\\ /Q \ o 

-r，. . . , m o' 1 」 . ^ 

This ‘mg didh t 匕 ome -fvom alio 匕 


^ Coyy, ov mutablcCopy, so ii ； || be 

autovclcascd. 



" 蛛 i 


h 3. 


NSString* themessage = [NSStrinc 

[activities objectAtlndex:[tweetPicker selectedRowInComponent:0]] 
[feelings objectAtlndex:[tweetPicker selectedRowInComponent:1]]]; 
NSLog(themessage); 






\i bo Coy\so\ 
see 七 hese message 


at to ⑽ atc 


Now all you need to update this to include the text from the Notes field. Take a look at the magnets on the next 
page and get it working. 
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{S] 


XcoJe Magnets 

You need to modify InstatwitViewController.m file to add the custom field 
to the message. Using the information you just learned and the magnets 
below, fill in the missing code. 


-( 工 BAction) sendButtonTapped : (id) sender { 

NSString* themessage = [NSString stringWithFormat :@〃 
I'm %@ and feeling %@ about it.〃. 


[activities objectAtlndex:[tweetPicker 
selectedRowInComponent:0]], 

[feelings objectAtlndex:[tweetPicker selectedRowInComponent:1]]]; 
NSLog(themessage); 
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magnets solution 


(0} Xcode Magnets Solution 

You need to modify InstatwitViewController.m file to add the custom field 
to the message. Using the information you just learned and the magnets 
below, fill in the missing code. 



InstatwitViewController.m 


-( 工 BAction) sendButtonTapped: (id) sender 


p “ 



NSString^ themessage = [NSString stringWithFormat : @ 
I'm %@ and feeling %@ about it.〃. 







[activities objectAtln 
selectedRowInComponent:0]], 


[feelings objectAtlndex:[tweetP gelectedRowInComponent:1]]] 


NSLog(themessage); 

F 把㈣ 

7 T ^ c si y' e ^ bZi 



£L 


靖磁％ 


A 孙 e 





so 




-a-bo^r, \ust like m 


TV^c ? \S a 。_冰 严 

Java o, C++, 如化 T SS “ 

•,s "bruc vt ks 七 value, 

。七一冰••七代七咖如 sceW . 


[themessage release] 
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Tqst DriVQ 


Go ahead and build and run the app with the new text code in it. 








im 


Wow it has dus-toi 

text/ v/OOil 
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Objective-Ccross 

Practice some of your new Objective-C terminology. 



Across 

5. The control with focus has_status. 

6. This incorporates another file. 

7. Unique names for methods after Objective-C translation are 


8. Signals that the compiler will retain the object. 

9. Automatic methods. 

10. This tells the compiler to skip mutexes. 


Down 

1. An array of objects that will be released after the current 
event. 

2. A"+" before a method declaration indicates that it's a 


3. This is sent between objects. 

4. _management is important for iPhone apps. 
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Your Objcctive-C Toolbox 

You’ve got Chapter 3 under 
your belt and now you’ve added 
Objective-C to your toolbox. For 
a complete list of tooltips in the book ， 
go to http://www.headfirstlabs.com/ 
iphonedev. 


Attribute 

You want it... 

vcadlw\ri*tc 

W\\cy\ you *thc pvopc\rty *bo be modi-fiablc by people- The ^ompilcv- will 

jc^cv-atc a a^d a settev- -fov- you. This is -the dc-fault 

v-cado^ly 

iVhc^ you do^*t wa^*t people modi-fymg *thc p\ropc\rty. Y^u 乙 a 的 s*till 

*thc -field value bddk'm^ -the p\ropc\rty, bu*t *thc ^ompilcv- >woir/*t jc^cv-a*tc B 

settev-. 

dssi^ 

W\\cy\ youVe dedl'm^ wrth bdsid -types, like nrrts, -floa*ts, d. The 乙 ompilev 
jus-t ^v-ca*tcs a setter with a Simple myPicldl 二 value This is -the 

de-fault bu 七 y\o{, usually wha 七 you wa^t 

v-rta'm 

youVe dcdlm^ y/i*th object values. The dompilev- v/ill vc*tam *thc value 
you pass \y\ (v/cll talk r»\o\rc about v-rta'mihj'm d mmutc) and \rclcasc *thc 
old value v/hc^ B ^cv/ erne domes *m. 

dopy 

\M\\cy\ you warrt 七© hold o^*to 3 dopy c^f some value ms-tcad o-f *thc value 
•rtscl*f. Fov- c^arnplc, i-f you y/ah*t io hold or\ijo 9r\ a\rv-ay a 灼 d do^*t v/arrt 
people *to be able io i*ts 匕 ojrrtc 的 *b a-f*tc\r -they sc*t it This se^ds a 

dopy message *to -the value passed m v-c*ta*ms 





S 


:二一一身 

^ Was 


av.d 


/Wemovy /Wahajcmcn-t 

-/ou must \rdcasc objects you 
v/i*th allod, hew, dopy oy mu*t«lblcCopy 

— Evcvythihg dsc heeds -to have 
a V"C*t3ih ^ouh*t o-f / 3hd ih 

au-fcov-clcasc pool 
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Objective-Ccposs Solution 

Practice some of your new Objective-C terminology. 



Across 

5. The control with focus has_status. 

[FIRSTRESPONDER] 

6. This incorporates another file. [IMPORT] 

7. Unique names for methods after Objective-C translation are 
_. [SELECTORS] 

8. Signals that the compiler will retain the object. [RETAIN] 

9. Automatic methods. [©PROPERTIES] 

10. This tells the compiler to skip mutexes. [NONATOMIC] 


Down 

1. An array of objects that will be released after the current 
event. [AUTORELEASEPOOL] 

2. A"+" before a method declaration indicates that it's a 
_. [STATICMETHOD] 

3. This is sent between objects. [MESSAGE] 

4. _management is important for iPhone apps. 

[MEMORY] 
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4 multiple VieWs 


參 


A table with a view 



Most iPhone apps have more than one view. 

We’ve written a cool app with one view, but anyone who’s used an iPhone knows that 
most apps aren’t like that. Some of the more impressive iPhone apps out there do a great 
job of moving through complex information by using multiple views. We’re going to start 
with navigation controllers and table views, like the kind you see in your Mail and Contact 
apps. Only we’re going to do it with a twist... 


this is a new chapter 






mix it up 



Sa% ba\rtchdc\r 

at the ttF 


Lounge 



This chapter is about multiple-view apps. What 
views would you need to have for a bartending 
app? 
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multiple views 



iPkone UI Design Magnets 

Using the components shown below, lay out the two 
views we’ll be using for the app. 



l/icvz 养 I \/icv/ 



_ 一一 IL 


Drink Mixer 


Lorem ipsurn dolpr si ■ 吁 r eHl 

lameE. consectetaiur cillium 
adiplslcing pecu. sod do 


elusmod temper incidldunl ut 


UaV)c\^ 


W/Tcx-tFicId wi ^ 

( P^chold 饮 


□QQQQQiDQa 
QQQQQQBQO 
O Q 咖 □□□ o 


MCiirfli 
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sam needs two views 



iPkone UI Design 
Magnets Solution 

Using the components shown below, lay out 
the two views we’ll be using for the app. 


£?心匕 卜 


the 

hS c) wet 


We ， \Ua\\ •七 
pwV. 




I 七 will aUo 

silOY/ youv 
a\>ps ti*tlc 


Uafcc' s 


：.： 


j.y > 


irtgrecJienls ： 


Lflffflm fjSr|un'i A»ur rjl qHiE 
l3md r conscdDlour cillium 
adipisicing peou, seid do 
&iu$4nod IfemcKK incidtdynt ut 


Direclions: 


LOrniti ipjclffi flOTOf nri ^HiE 

lame1 r conscclolour cillium 
adipis^ing sad do 

eiusmod inQidtdynt lit 


K/Tcx-tpicId with 
placeholder -tex-t 


W/S^v-olll/i 


icw 


\/icv/ ^1 


\7iev/ 养 i 


Sa 眯 heeds a list <y( dv-*mk ha^es ar\d -to be able 
*bo look up wha*t’s m *thcr^. Wt\\ also y/ah*t *bo 
khow hoy/ mudh he heeds o-f eddh mgvcdiich-t) 
dhd ar\y mst\rud*tior\s — s oh *the vodks, 
whethev *bo shake o\r s*tiv, y/hcr\ *bo *thi^3s 
ov\ -fire, d So -for our *two views, y/cll pu 七 
■the dv-'mks *m d lis*t (view 养 I), when Sam 

{^ys or\ o\r\t y/dl shoy/ {\\c dcbdils (vicy/ 养 Z). 


WicVc not ^onr\^ "to use "t^c 
kevbodV"di -Pov- r\ov/ - >*bs 
a v-c*fcv"cr\tc apf) and Sam 
\us*t r\ccds *to v-cad s*biAd.. 


BQQQiQiQQQ 
BQQQSQBQQ 
o iQQQiDO^ 
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multiple views 


So, how do these views 




fit together? 

Before you pick the template for our bartending app, take 
a minute to look at how you want the user to interact 
with the drink information. We’re going to have a 
scrollable list of drink names, and when the user taps on 
a row, we’ll show the detailed drink information using 
view #2, our detailed view. Once our user has seen 
enough, they’re going to want to go back to the drink list. 


users 3^ ^ 


sc\cth a W. 


赠 k wi-th... 





. 

Below are the templates available for an app. Which do you think we should 
use for DrinkMixer? 


Window-based Application □ View-based Application 


I I Utility Application 


Tab Bar Application 


口 OpenGL ES Application 


□ 


Navigation-based Application 
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working with hierarchical data 


The navigation template pulls multiple views together 


For this app, we’re going to use a Navigation-based 
project. To get started, go into Xcode and choose the 
File^New Project option. Choose the Navigation- 
based application and save it as DrinkMixer.proj. 
Make sure that “Use Core Data for storage” is not 
checked. 


The navigation template comes with a lot of 
functionality built in: 


Jus*t says, a 

^av'i^d'bioh toir\*bv-ollc\r is Wil 七 
•m. I 七 f\rov*idcs badk buttons, 

title ba^rs, a^d a view 

•bv^at will keef youv- user 

*tWou 分 d 3 *t 3 

y/'i*tV)OiA*t yttmj lost 



Lemon Drop : Citron 
vodka, lemon, and 
I 


^ havc daia 

f° ov ； 3 f 〜The havi 9 aiio h 

helps us -to ry»oVC 


sugar 
the rim 
pour inc 
shaker. 


Firecracker : Wild 
turkey and hot sauce. 
Pour ingredients into 
a rocks glass filled 
with ice. 


丁 he Waviga*tioh Coh-t\rollcv- 
Provides ivahsitiohs 
between views with 
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multiple views 


The navigation template starts with a table view 


The navigation template comes with a navigation controller and a root view that the controller 
displays on startup. That root view is set up as a table view by default, and that works great for 
our app. A table view is typically used for listing items, one of which then can be selected for 
more details about that item. ., . 

-template 







TWlS IS 70 U 11 

jf'md tatk 

title ^ 



〜 hdviga-tioh 
^OY\i}roHe\r 
Provides a 


The table view 


Cup^rtlina 

Gaendalo 

Los 

Palo AJto 
gan Dke§Q 

Fraitclsea 
^anld Claia 
San la Monica 


nsnpf|A| 

n If m 1 


there ^ are no ^ 

Dumb Questi9ns 


丁 he table viev/ provides an easy 
y/3y *to y/ov*k wi*t^ da*t3. I 七 S"t 3 V"*ts 
9 v\ Ct^yiy, Stv-ollablc list (or 
•tv^c n>dm View o( you\r affl^aton. 


If the navigation template is about 
handing lots of views, why does it only 
come with one? 

Most navigation-based applications 
start out with a table view and show detailed 
views from there. How many detailed 
views, what they look like, etc. are very 
application-specific, so you have to decide 
what views you want and add those views. 
The navigation template doesn’t assume 
anything beyond the initial table view. 


What built in apps on iPhone use 
the Navigation control? 

Contacts and Mail, which are both core 
iPhone apps, use this design. It’s a good 
idea to get into those apps on your phone to 
see how the entire template is implemented. 
For a neat twist, take a look at the Messages 
(SMS) app. That one uses a navigation 
controller but frequently starts in the “detail” 
view, showing the last person you sent or 
received a message from. 


Do I have to use a table view for my 
root view? 

No, it’s just the most common, since it 
provides a natural way to show an overview 
of a lot of data and have the user drill down 
for more information. Table views are very 
customizable, too, so some apps that might 
not seem like table views really are, like 
Notes or the iTunes store, for example. 
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add your app title 



Tesr DriVq 


Add a title to the main view right away, and take a look 
at what your empty table view will look like. Open up 
MainWindow.xib in Interface Builder... 


Lc-pt c\\ek Mviyticm 

Co^bro\ I -to 

uf i\\t ks\>ct*to\r- 


fcav - 




\\ add 


SOOW 



^avigaciDn Concraller 







A 


Ndvi||j^Kjri SL«ni AUtiLhiIcl 


年 




ttavin^tlorv Itam 


Tllk 

PrumpE 



DwiiA Mix 专 r 


r 


,_J 


Aark BuEoein 

1 



A^d add ' 

i\\t |y\sfcd*bo\r> here. 




If you don’t add the title here, you won’t have a back 
button later. 

. r #.i Setting the title for the main view of the app means that additional 
U* views will automatically have back buttons to get to the main view. 
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multiple views 



T]ie Ta^le View Up Cl^se - 

Navigation controllers and table views are almost always used together. 
When you selected the navigation-based project as your template, Xcode 
created a different view setup than we’ve used in the past: 



MainWindow.xib 


AO 


TiJb^ 


Cupe 


7\ 


upertlno 卜 tabic 

Gienciaie v'icv/, *tW»s 

bav 

Loa ? | a6c ^oldcv 

Palo Alta ^\rov'>dcd 

waae,. 

Clara 

San la Mon icA 






su?? o^ u WtWwtk M 呼 w 
bav. 


A UI Nav» 53 t»o\r\Cor\*tv-ollcv- 

s*t3V" , ts ou 七 y/i't-V' 3 w»a •… viev/) 
y/WidV^ m tV^'is is … 


..a U|Tablc\/'ic>w »s loaded 

Root\/'iC>NCorrt\rollc\r.%'ib. k *t^is 

•template, RooWiowCo^ollcv- is d 
subclass J< U|lablc\/ic>wCo^*byollc\r. TV^c 
UlTablcVicv/Co^ollcv ^ovidcs some 

bas'id table bAav'iov-, like 七 

datasou^c and delegate ^ .Vs loaded Vom 

b, dnd fv-ovidmj editmj s*t3"tc tor\*tv"ols. 


a Y\\\ 


l/Vc II -talk about tV^csc mov-c as wc 50 . 



RootViewController.xib 
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come together, right now 


A table is a collection of cells 


The UITableView provides a lot of the functionality we need 
right away, but it still needs to know what data we’re actually 
trying to show and what to do when the user interacts with 
that data. This is where the datasource and delegate come in. 
A table view is easy to customize and is set up by the template 
to talk to the datasource and delegate to see what it needs to 
show，how many rows, what table cells to use, etc. 


£ 。‘ , ,e W 

k \A / WC ^ ih 






Tjblr VIpiv 






/ 






1! TT 

^Ppoir-t cd\i' 

，心也 i ， dudi h al ovihA ^ ^^^ 

^ d) dM'^a ， o WS 2 
鳥 ， wcj ^ 




ay -them ou-t ahy way y ou wahi 


Cupertino 
Qflendale 
Los Angeles 
Palo Alto 
San Diego 
San Francisco 
Santa Clara 
Santa Monica 



六 taWc w 。岣 一 0 : 

toW 一 W 6— 叫 Y 
-table 6 c\\s- 


ar,d a footer- w 7 S^ 0r 

s aW^ 0YiC Ao ^ 

pvmkM'^v. 


Ppp^npp^^i^PiwvvvipHl 

- - -- 二 




vovis) avc m cath sc^ 



Look through some of the apps you have on your device. What are 
some of the most customized table views you can find? Are they using 
sections? Are they grouped? How did they layout their cells? 
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multiple views 



Ta^Je Cell Cde Up Ckse 


Below is an excerpt from our updated RootViewGontroller.m file. This is where we create table cells 
and populate them with the drink list information. 


TV)c i\\t 匕呼 0 ' 

W ⑽ mJotr needed tell. 

// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath 
: (NSIndexPath *)indexPath { 


TW»s mrbWtailed 
厂 讪⑼ 如 table 

I 灼饮如 a 


static NSString *CellIdentifier = @〃Cell 



It ⑽二士 e 

7 7 owVe yabb 岣咏 e —Umd. 


suve 


[tableView dequeueReusableCellWithldentifier:Celll 


UITableViewCell *cell = 
dentifier]; 

if (cell == nil) { 

cell = [[[UITableViewCell alloc] initWithStyl^:UITableViewCellStyle 
fault reuseldentifier:Cellldentifier] autorelease]; 



㈣: 托 ^ 

七 \dc^r ava.IaWc- 


■to y 


|-f ^ 

available ^ 矿 cuSC, 

^11 dvea 七 e a …娜 


// Configure the cell. 

cell.textLabel.text = [self.drinks objectAtlndex : indexPath.row]; 

return cell; 


t 逆 

s ? tt\U a^mk v^ccd to sV^ov/. 


- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView 
return 1; 


// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInte 
ger)section { These methods tell tabic view 

settlors y/c V^avc ar\d 
w>3^Y y-oy/s m section. 


return [self.drinks count]; 
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populate your table view 


tliereiare no o 

Dumb Questi9ns 


How do cells get into that reusable 
list to begin with? 

The table view handles that. When 
cells scroll off the screen (either the top or 
the bottom,) the table view will queue up 
cells that are no longer needed. When it 
asks the datasource for a cell for a particular 


row, you can check that queue of cells to see 
if there are any available for use. 

I don’t understand the cell 
identifier... does it have to be “Cell ”？ 

No 一 that's just the default. When 
you do more complex table views, you can 
create custom cell types depending on what 


data you’re trying to display. You use the cell 
identifier to make sure that when you ask 
for a reusable cell, the table view gives you 
back the type you expect. The identifier can 
be anything you want—just make sure you 
have a unique name for each unique cell 
type you use. 


jhsrpsn your pencil 

It’s time to start displaying some drinks. You’ll need to make 
some modifications to both the RootViewController.h and 
RootViewController.m files. 



Declare the drinks array. 

Using syntax similar to what we used for the picker, declare an array called 
drinks in RootViewController.h with the necessary properties declaration. 


❺ 

o 

o 


Implement and populate the array. 

In RootViewController.m, uncomment and expand the viewDidLoad method 
to create the array with the drinks from the drink list here. 


Tell the table how many rows you have. 

The auto-generated code needs to be modified to tell the table that it will 
have the same number of rows as there are drinks in the array. Modify the 
implementation file under this line: // Customize the number of 
rows in the table view. 

Populate the table cells. 

Implement the code that we talked about on the previous page in Table 
Cell Up Close so that the table gets populated with the items from the 
array. 


I>Hhk List 

Moji-to 
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multiple views 


Wait, memory on the iPhone is 
a big deal, right? How can we 
put in all those drinks? 


Like everything else on iPhone, the 
UlTableView has to worry about memory. 

So, how does it balance concerns about memory with an 
unknown amount of data to display? It breaks things up 
into cells. 


Each drink gets its own cell... sorta 


The UlTableView only has to display enough data to fill 
screen — it doesn’t really matter how much data you migt 
total. The UlTableView does this by reusing cells that scr 
the screen. 



an iPhone 
data you might have in 
Lg cells that scrolled off 


I v\cvi V^as "to s6vo\\ 3 
^ table ^ 

^ t ^ voYi . 


9° 



T t C ^ ^ ^ view 

厂 ’^ o a bucket u,-ti| iPho, c hC cds 

r : 毗…⑽ 

4 h thc " heh 从 e spoils. 

/// 




Tvl data 一一 七 

u Ws ava'laWc .1 工丄 



solut Mixerj 



t 


Th，S is ^ ^iv c 

Ulc ^lls ihai 

ST， 


■ ■個 _，-■ ■— 

Captain 


|Jf aw *t ^ ^ 

一 d 加， 
6 vcates a ^ or,c 
srts 如 6 。如七 . 
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sharpen your pencil solution 


«^harp your pencil 

Solution 


It’s time to start displaying some drinks. You’ll need to make 
some modifications to both the RootViewController.h and 
RootViewController.m files. 



Declare the drinks array. 


UlTabicV'c^Co^vollcv 

V^a ▲如 datasourdc 

a^d delegate U 70U, 

so ^ ^ 

dcdlavc V^cvc* 


Qinterface RootViewController : UITableViewController { 

NSMutableArray* drinks; Add -the hew dvihks 
} — - s^ay. 

©property (nonatomic, retain) NSMutableArray* drinks; 

@end 


pcdlarc the ^ 

-fov 

i\^t dv4s avvay 



RootViewController.h 



RootViewContrdler.m 


(void)dealloc { 

[drinks release]; 

[super dealloc]; 

} 

@end 
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multiple views 


T W,s ^ / 匕 

vted 七 . 




Implement and populate the array. 

In RootViewGontroller.m, uncomment and expand the 
ViewDidLoad methods. 


ft 




- (void)viewDidLoad { 
[super viewDidLoad] 


RootViewController.m 


NSMutableArray* tmpArray = [ [NSMutableArray 
alloc] initWithObjects : @ "Firecracker”，Lemon Drop ”， 

@ "Mo j i to" ， nil ] ; dWks v/ey W 

self.drinks = tmpArray; 

[tmpArray release]; 


// Uncomment the following line to display an Edit button in 
the navigation bar for this view controller. 

// self•navigationltem•rightBarButtonltem = self. 
editButtonltem; 



Tell the table how many rows you have. 


TWis used *to 
vcbuvv \ ： 0- 


// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInS 
ection: (NSInteger) section { (v/o>w rt *tclls *tablc view 

return^[self. drinks count] ; 一 have same humbev- of vows as *tKc 

灼 umbev* of i*tcr«s *m dv^mks av*v*3y 


Populate the table cells 


// Configure the cell. 

cell.textLabel.text = [self.drinks objectAtlndex : indexPath.row]; 

return cell; ^ Hcvc dusWi« dell Wrth 七 he 

1 *m-pov-matioy> -fov *tV>c spcdi-fid dvmk y/C y\ttA *to sliov/. 
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a taste of whafs to come 




Tesr DriVq 


Now you’re ready to go. Save it, build and run, 
and you’ll see the three drinks in your app in the 
main view. 



丁十 t o 十 ： t W 

屮 \\\ sCxoW) *to 0 - 


Everything looks great. I’ll just 
email over our complete list—ifs 
40 drinks... 
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multiple views 


You mentioned the table view’s 
datasource and delegate, but why didn’t I 
have to declare anything like we did with 
UlPickerView? 

Great catch. Normally you 
would, but the navigation-based 
template we used already set this up. 

To see what’s happening, look at the 
RootViewController.h file. You'll see that 
it is a subclass of UlTableViewController, 
and that class conforms to the 
UlTableViewDataSourceProtocol and the 
UlTableViewDelegateProtocol. If you look in 
RootViewController.xib, you'll see that the 
table view's datasource and delegate are 
both set to be our RootViewController. If we 
weren't using a template, you’d have to set 
these up yourself (we’ll revisit this in 
Chapter 7). 

I noticed we used an 
NSMutableArray. Is that because we had 
to initialize it? 

No—both NSMutableArray and 
NS Array can be initialized with values 
when you create them. We're using an 
NSMutableArray because we’re going to 
manipulate the contents of this array later. 
Well get there in a minute. 

What’s the nil at the end of the 
drink names when we create the drink 
array? 


tliereiare no o 

Dumb Questi9ns 

NSMutableArray's initializer takes a 
variable number of arguments. It uses nil to 
know it’s reached the end of the arguments. 
The last element in the array will be the 
value before the nil—nil won’t be added to 
the array. 

Tell me again about that @ symbol 
before our drink names? 

The @ symbol is shorthand for 
creating an NSString. NSArrays store arrays 
of objects, so we need to convert our text 
names (char*s) to NSStrings. We do that by 
putting an @ in front of the text constant. 

When we customized the table 
view cells, we used the cell.textLabel. Are 
there other labels? What’s the difference 
between cell.textLabel and cell.text? 

Before iPhone 3.0, there was just one 
label and set of disclosure indicators in the 
default cell, and it was all handled by the 
cell itself. You just sent the text you wanted 
on the cell.text property. Nearly everyone 
wanted a little more information on the table 
cells, so in iPhone 3.0, Apple added a few 
different styles with different label layouts. 
Once they did that, they introduced specific 
properties for the different text areas, like 
textLabel, detailLabel, etc., and deprecated 
the old cell.text property. You shouldn’t 
use cell.text in your apps—Apple will likely 
remove it at some point in the future. We’ll 
talk more about the other labels later in the 
chapter. 


You mention that we can use 
section headers and footers—how do you 
specify those? 

The datasource is responsible for 
that information, too. There are optional 
methods you can provide that return the title 
for section headers and the title for section 
footers based on the section number. They 
work a lot like our cellForRowAtlndexPath, 
except they only return strings. 

What’s the difference between 
a plain table view and a grouped table 
view? 

The only difference is the appearance. 
In a plain table view, like the one we’re 
using, all the sections touch each other and 
are separated by the section header and 
footer if you have them. In a grouped table 
view, the table view puts space between the 
sections and shows the section header in 
bigger letters. Take a look at your contact list, 
then select a contact. The first view, where 
all of your contacts are listed together and 
separated by letters is a plain table view. 

The detailed view, where the phone numbers 
are separated from email addresses, etc, is 
a grouped table view. 
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whafs in a neon geek? 


Just a few more drinks 



七 k i 
o^k °^ : 




I 


丁 V^c dv-'^k wc ⑽ 
Head f L-o— c 
/\-0 to6k*ta^ s - 


V^as 


Rum Gunner 

Key WssTl 009 

Zl St Le mo nade 

Neapolitan 
Po’o Cocktail 
= r P’e Vurnrny 
Geek 
? ami ng Nerd 

Bn L u tter Bo ^b 

okmaker^s Luck 

® aked Appi e 

ip:： b 

B，a B C e f^san 

® eet, e Juice 

Ter minator 

Lo<ft rbread Man 

MUSi ^ fvSunset 

Cafe j 0 y 

Sa "clb ar Sleeper 


Get ready to 
start typing. 
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^ — 


This sucks. Can’t we just import 
the list Sam sent us somehow? 


We could, but not the way we’re set up now. 

Since the drinks are populated with an array that’s hardcoded 
into the implementation file, we can’t import anything. 

What would work well is a standardized way to read and 
import data; then we would be able to quickly get that drink 
list loaded. 



What can we do? There needs to be a way to 
speed up the process. 
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put your data in a plist 


Plists are aw easy way to save 
and load data 

Plist stands for “property list” and it has been around for quite a 
while with OS X. In fact, there are a number of plists already in use in 
your application. We’ve already worked with the most important plist, 
DrinkMixer-Info.plist. This is created by Xcode when you first create 
your project, and besides the app icons, it stores things like the main 
nib file to load when the application starts, the application version, and 
more. Xcode can create and edit these plists like any other file. Click on 
DrinkMixer-Info.plist to take a look at what’s inside. 
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multiple views 


Puilt-iw types can save and load 
from plists automatically 

All of the built-in types we’ve been using, like NS Array 
and NS String, can be loaded or saved from plists 
automatically. We can take advantage of this and move 
our drink list out of our source code. 



^\\ ouv dvmk U 

O 乩 oUk 

\,crt a ^ 


- (void)viewDidLoad { 
[super viewDidLoad] 


NSMutableArray* tmpArray = [ [NSMutableArray 
alloc] initWithObjects : @^Firecracker /A , Lemon Drop' 
@’’Mojito’’ ， nil]; 

self.drinks = tmpArray; 

[tmpArray release]; 

// Uncomment the following line to display an Edit 
button in the navigation bar for this view controller. 

// self•navigationltem•rightBarButtonltem = self. 
editButtonltem; 





Before you import Sam’s list, let’s create a sample plist that’s the same format. We’ll make sure 
we get that working properly, and then pull in Sam’s list. 

O Create the empty plist. 

Go back into Xcode and expand the Resources folder. Right-click on 

Resources and select Add — New file, Mac OS X Resource, and 

Property List. Gall the new list DrinkArray. plist. u Rcsouv6c 

Ma t s & VvV 士“七 

/vid 祕 6CS. 

Format and populate the plist. \\sitA 1 

Open up the file and change the root type to Array and the item types to 
strings. Then you can populate the names for the drinks. 
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get your plist working 




E^eRciSe 


With the sample list created, we can use it for 
testing before we get the big list. 


o 


Create the empty plist. 

Go back into Xcode and expand the Resources folder. Right-click on 

Resources and select Add ~^ New file, Mac OS X Resource, and 
Property List. Gall the new list DrinkArray. plist. 


Fill 

Jft C«vnpljli f-dr ifauw ai 零 ur 

■ Wlmmm 




theyire listed hcv-c. 


r^*s niL 

lifVtrUird! 
RibiiHU 
^Mv SifflVTTi 

C_Ciui 
c and (：+« 





O 





^ncCkcH 


ftop4eny Iiei 


: pr^pri «T|i bu Ail 


Ckk 70 UV 

? \\si pvmWWa7 ?V，st 



Cmel 




I*™ 



Format and populate the plist. 

Open up the file and change the root type to Array and the item types to 
strings. Then you can populate the names for the drinks. 
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multiple views 


Arrays (awd more) have 
built-iw support for plists 

Changing the array initialization code to use the plist is remarkably easy. 
Most Cocoa collection types like NS Array ad NSDictionary have built-in 
support for serializing to and from a plist. As long as you’re using built-in 
types (like other collections, NS Strings, etc.,) you can just ask an array to 
initialize itself from a plist. 

The only piece missing is telling the array which plist to use. To do that, 
we’ll use the project’s resource bundle, which acts as a handle to application- 
specific information and files. 


- (void)viewDidLoad { 

[super viewDidLoad]; 

NSString *path = 
ofType : @"plist"]; 

NSMutableArray *tmpArray = 

initWithContentsOfFile:path]; 

self.drinks = 


^ 卜 PP bundle U a 

P^th to oum plisi 


[[NSBundle mainBundle] pathForResource : @ A, DrinkArray y 


[[NSMutableArray alloc] 


tmpArray; ^ ? l^ 

[tmpArray release]; 






_ 


inn 


RootViewController.m 


Tost DriVq 


After you’ve finished up these two things, 
go ahead and build and run. It should look 
the same, with just the three drinks. 



Once this list works, head over to http://www.headfirstlabs/ 
iphonedev and download the DrinkArray.plist file. It has the 
complete list of the drinks from the Head First Lounge. Drop 
this in on top of your test plist, rebuild DrinkMixer, and try it out! 
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a full drink list 




TesT DriVq 
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multiple views 



Now we just need 
to get that detail view 
all set up, right? 


Creating your detail view 
will complete the app. 

The entire list of drinks is great, 
but Sam still needs to know what 
goes in them and how to make 
them. That information is going 
to go in the detail view that we 
sketched up earlier. 


■ 






. 

How are we going to get from the list to the detail 
view? And how are we going to display the details? 
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a familiar pattern 


Use a detail view to drill down into data 


Earlier, we classified DrinkMixer as a productivity app and we chose 
a navigation controller because we have hierarchical data. We have a 
great big list of drinks loaded, but what Sam needs now is the detailed 
information for each drink: what are the ingredients, how do you mix 
them, etc. Now we’ll use that navigation controller to display a more 
detailed view of a drink from the list. 

The standard pattern for table views is that you show more information 
about an item when a user taps on a table cell. We’ll use that to let the 
user select a drink then show our detailed view. The detail view follows 
the same pattern as our other views: 





taves about ^ 

sWM dc-ta'«U w 
Will W ov, 

OY\t dbr»A. 


The -table vWs 6ov\tv-ollcv- 
(ouv RooW'C^Co^v-ollcv) 

: 以 上二旧 vr 

y,av *to sV^ov/ the 

ac*ta'»lcd 


The dtia\\ ^ sV^ov/s all 
cleats tV.at ^akc u ? a 
如 - 如 I—， ⑼ is aw 
^ -bo 铣 cw. 



L\. tr ^ 

wr 丄 。—、、 t 

t o^o\W- 0- AVm a m ^ 
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A closer look at the detail view 

We sketched out the detail view earlier — but we need to look 
more closely at what we’re about to build. 







It will be popula-tcd Wi-th 
ay\d the d\rihk ihfo, 
so wc doY\ l i heed a bbcl 






2 -Ci' 


Bddk bu*t*toh 


irrgredienls 


Lgr^m ip^unn pglgr i*w eHiE 
lamd F consc'Clntour ciltium 
adipm^ng p^cu. do 

(emcKj# ino^unt ut 


Direclions: 


L^irpm ip^gm pglQi" fhr pit 

lanvl. conseclDlaiiT dllium 
adipnsidng pecu. sed do 
»iU64nod lemaar ifK>tdtdynt ut 


临釺 Reid the 

d\rihk 






Let’s start tuilctingf... 
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create your detail view 



ExGRdSe 


You’ve got the hang of this now. Start building your detail 
view by creating the files and code you’ll need, then put it 
together in Interface Builder and wire it up. Get to it! 


o 


❺ 


Create the files you'll need. 

To create the new view, you need a new 氺 .xib file, as 
well as the supporting header and implementation files. 
The file type is a Cocoa Touch Glass type, and it’s a 
UIViewGontroller subclass. 


Lay out the new view in Interface Builder. 

Use the library to drag and drop the elements that you need 
and build the view we sketched out earlier. 

Here’s a hint: to reserve the space for the navigation 
controller, just bring up the Inspector, and under 

Simulated Interface Elements, Top Bar, select 
Navigation Controller. That will make sure that you lay 
out your view below the navigation bar. 




Write the code to handle the declarations and 
outlets for the new fields. 

You’ll need to work in both D e tail Vie wG ontroller. h 
and DetailViewGontroller.m. Gall the new text fields 
nameTextField, ingredientsTextView, and directionsTextView. 



Connect the detail view to the new outlets. 

Just like we did for InstaTwit, use Interface Builder to make 
the new view work. 



Make the text fields uneditable. 

Using the inspector, find the checkbox that makes the fields 
uneditable. 
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tJiereiare no ^ 

Dumb Questi9ns 


We keep drawing the datasource, 
view, and view controller as separate 
things, but then we stick them together 
into the same class. What’s going on? 

It’s all about the pattern. In general, 
you'll have a few defined in a nib, a view 
controller backing it, and a set of data 
it needs to work on. Whether these are 
combined into one class or not really 
depends on the complexity of your 
application. If you’re not using Interface 
Builder, you can go completely off the deep 
end and have your single class create the 
view programmatically. Well show more 
of that later in the book. Conceptually, 
however, you still have a view that’s 
calling into the view controller when things 
happen. Likewise, you usually have one or 
more datasource protocols being realized 
somewhere that are providing data to your 
view. 

Why do we have to move the *.xib 
file into the Resources group? 

You don’t have to, but we recommend 


it to help keep your code organized. Different 
developers use different groups, things like 
“User Interface”，"Business Objects”, “Data 
Objects”, etc. Xcode really doesn’t care; it’s 
just important that you know how your code 
is organized and you can find what you're 
looking for. Reusing a structure that others 
will recognize is a good practice so people 
can pick up your code quickly and you can 
understand their code. We use the templated 
defaults in this book. 

What are other ways to save data? 

There are quite a few of them. We’ll 
cover the more common ones in this book in 
different projects. The one you’re using now, 
plists, is the simplest, but it does limit what 
you can save and load. That doesn’t make it 
bad; if it works for what you need, it's a fine 
solution—it's just too limited for everything. 
There’s a serialization method called 
NSCoding that works well for custom objects, 
but can make version migration a challenge. 
iPhone supports saving and loading to a 
database using SQLite. This used to be 
the preferred way to go if you have a lot of 
data or need to search and access it without 
loading it all into memory. However, with 


iPhone 3.0, Apple introduced Core Data. 
Core Data is a very powerful framework that 
provides an 00 wrapper on persistence and 
has nearly all of the benefits of using SQLite. 
It’s definitely not trivial to get started, but it’s 
really powerful. Well build an app on it later. 

Why didn’t you use a label for the 
name field? 

UlTextFields allow you to have 
placeholder text that appears in the field 
when it’s empty. Rather than using up screen 
space with a Name label, we chose to use 
the placeholder. If the meaning of the text 
shown on the screen is obvious to the user, 
consider using placeholder text. 

So why didn’t we use it for the 
ingredients and directions? 

We could have, but since those contain 
multiple lines of text, we wanted to break 
them up with labels clearly showing what 
they were. Ultimately it's an aesthetic and 
usability decision, not a technical one. 



BULLET POINTS 


■ Productivity apps work great with 
hierarchical data. 


■ iPhone tables only have one column 
but can render custom cells. 


■ Navigation controllers are a good 
way to manage multiple views. 


■ Tables need a datasource and a 
delegate. 


■ Table views usually go with 
navigation controllers. 


■ Multiple views usually mean multiple 
*.xib files. 
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long exercise solution 


BteRciSe 

§OLyiiOH 

o 


Here’s all the info for the new detail view. After this, you 
should have a working (but still empty) detail view. 


Create the files you'll need. 

We need a new .xib for the detail 
view. To create one from scratch, go 
back into Xcode and click on the 

File - ^New File... menu option 

Jlakc swrc ihai y ou have 
C 广 Wh Class | ihC 

selected Uhdcir iPhohC OS. 


The new file dialog box has lots 
of options for making new files. In 
our case, we need both the nib and 
the supporting files, so we need to 
create a new Cocoa Touch Glass 
with .m and .h files, and the .xib file. 




F|l 


Niw UlVi^ttPCanir^lIrr ■iiibrlJLiA 3CIB 


, 16 ft I prlnkO^EillVl ⑽ _ 

J AIl-d ^rinLEMuiViif^ jpnli^ilBr.h 

LEx^Eian' 'Of 认【叩 / nnnkhfEcrrJ 

4 iki Ip Ptu^rcl UrlrricMlxer 
Targfrr 1 


A ■■ct 


QlH-Ci M [#mplJLl* FH niUi flli^ 

■ 



lh«H 

lAirfljiir 






njftMM 


hWirWr 
ii-VHIIC： + 

kn-pfp;. iLuiLdir Ku 
dlhir 



•1 Chpow- 


One more thing. Xcode will create 
all of your files in one directory. 

To keep the files organized in 
your Xcode view, move the 
DrinkDetailViewGontroller.xib file 
into /Resources. 


Cancel 


PrwiiRjs- ( finish 
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❺ Lay out the new view in Interface Builder. 

TWC W 
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long exercise solution 



Here’s all the info for the new detail view. After this, you 
should have a working (but still empty) detail view. 



Write the code to handle the declarations and outlets for 
the new fields. 



#import <UIKit/UIKit•h> 

Qinterface DrinkDetailViewController : UlViewController { 

IBOutlet UITextField *nameTextField; 

IBOutlet UITextView *ingredientsTextView; 
IBOutlet UITextView *directionsTextView; 


©property 

Qproperty 

Qproperty 


(nonatomic, retain) 
(nonatomic, retain) 
(nonatomic, retain) 


UITextField *nameTextField; 


UITextView *ingredientsTextView; 


UITextView *directionsTextView; 


@end 




DrinkDetailViewController.h 




@implementation DrinkDetailViewController 

@synthesize nameTextField , ingredientsTextView , directionsTextView; 





DrinkDetailViewController.m 
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multiple views 



DrinkDetailViewController.m 


o 




- (void) 


dealloc 



[nameTextField release]; 

[ingredientsTextView release] 
[directionsTextView release]; 

[super dealloc]; 


Connect the detail view to the new outlets. 

All three outlets, the directionsTextView, the 
ingredientsTextView, and the nameTextField need to 
be connected to their spot on the new view. 
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almost there... 




ipl jIT 1-1 ^ 

"■aniiKSM'Jf《llllgw «l*t 
dn _tii 

,• fcki r r 

■iinurr- ^ 


UvuActk 七 Wis 
{p 七 he 

toY\icv\{^ o-f 

U|Tc%W'ic^s. 

Make the text fields un-editable. 

We need to disable both the UITextField and 
the two UITextViews to prevent the user from 
making changes. Simply click on each field and 
toggle the Enabled checkbox to off. 

Once those changes are made, the keyboard 
issue goes away, because there won’t be one! 


TIM Vit_ 

Tesii 




Tqst DriVQ 


Build and run your app. You just put in a lot of work, 
and it’s a good time to check for errors. 
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multiple views 





We still neect to get tkat ctetail view 
to load wken Sam selects a drink. 



When your users browse through the drink information, they’re going to need to switch between 
our list and detail views. Think about how we do that while keeping the user from getting lost. 



How does the user navigate between views? 



How can we keep track of what view to show? 



How does the detail view know what drink to show? 




How do you get the user back to the table view? 
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keeping track 



When your users browse through the drink information, they’re going to need to switch between 
our list and detail views. Think about how we do that and keep the user from getting lost. 


|n i\\t simula-bov-, 



❶ How does the user navigate between views? The us 伙 is 9 o*m3> tKc dell of tKc 

七 -they *to see. 

O How can we keep track of what view to show? j— will keep with bddk 

buttons a^d *thc of 七 he 


O How does the detail view know what drink to show? based oh ihe iable dell ihai 


the user sclcdts. 


o How do you get the user back to the table view? 丁 ^ CoY\bro\W suf>f>ly d bddk 

button *tha*t t^Y\ yt us badk to *the rna'm view. 
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multiple views 


Use the navigation controller to switch 
between views 


Now that we’ve got the table view populated and the detail view built, 
it’s time to manage moving between the two views. The navigation- 
based template comes preloaded with the functionality we need: 




A view stack for moving between views 

As users move back and forth, you can ask the navigation 
controller to display the appropriate view. The navigation 
controller keeps track of where the users are and gives them 
buttons to go back. 




A navigation bar for buttons and a title 

The navigation controller interacts with the navigation bar 
to display buttons that interact with the view being shown, 
along with a title to help the users know where they are. 




A navigation toolbar for view-specific buttons 

The navigation controller can display a toolbar at the 
bottom of the screen that shows custom buttons for its 
current view. 


The UINavigationGontroller supports a delegate, called the 
UINavigationG ontrollerDelegate, that gets told when the controller 
is about to switch views, but for DrinkMixer we won’t need this 
information. Since the views get told when they’re shown and 
hidden, that’s all we need for our app. 


Now we neect to get tke table 
view and nav controller working 
togetker to display tke detail view. 
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Navigation controllers maiwtaiw a stack of views 

We’ve been dragging the navigation controller along since the beginning of 
this project, and now we finally get to put it to use. The navigation controller 
maintains a stack of views and displays the one on top. It will also automatically 
provide a back button, as well as the cool slide-in and out animations. We’re going 
to talk more about the whole navigation controller stack in the next chapter, but 
for now, we’re just going to push our new view onto the stack and let the controller 
take care of the rest. We just need to figure out how to get that new view. 






Out ^ 产 V/ 

•,s dvea-bed , 』 

use 

to^oWtr -to 








Delegate 





^ delete -etW js 

dalled, ou, Ld 

(如 delete)，eeds a，d 

一如 dcta«i V«cv/ 


Well use the tap notification iw the table view delegate 

When a table row is touched, the table view calls tableview : didSelectRowA 
tlndexPath: on its delegate. The table passes along an NSIndexPath (just like 
cellForRowAtlndexPath) that tells us which row was selected. 

Here’s where it gets interesting: our RootViewController is our delegate, so it needs to 
hand off control to the view controller for our detail view... 
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Instantiate a view controller like awy other class 

The only piece left to create is the view controller. Instantiating a view controller is no different 
than instantiating any other class, with the exception that you can pass in the nib file it should 
load its view from: 

[[DrinkDetailViewController alloc] initWithNibName : Q^DrinkDetailView 
Controller" bundle : nil]; 

Once we’ve created the the detail view controller, we’ll ask the NavigationGontroller to push the 
new view controller onto the view stack. Let’s put all of this together by creating the callback 
into the delegate and creating the new view controller to push onto the stack: 


#import ''RootViewController • h" 

#import ''DrinkDetailViewController. h ; 




Smde Wve — 吒 匕 
i\,t ^ ^ do^vollcv, 


// Override to support row selection in the table view. 

- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSIndexPath 
*)indexPath { K _ delegate dallbadk - 七 k mdc^Pa't^ 


*tclls us y/V>i 乙 h v*oy/ (dv*nr>k) >wds sdcd*tcd- 


// Navigation logic may go here -- for example, create and push another view 
controller. 


( ^ do^ollcv... 


DrinkDetailViewController ^drinkDetailViewController 
[[DrinkDetailViewController alloc] initWithNibName : @ 〃 DrinkDetailViewController ; 
bundle : nil]; 


[self.navigationController pushViewController : drinkDetailViewController 
animated:YES]; /K … 七 • ， 七。山七 ^ 

[drinkDetailViewController release] ; V - - 


• * i 

^av'i^at>ov\ 


“ 从 aU“ _七广 co^broWt 

V,as detail 6 士 1 卜 : “孙 
vdease ouv -to 


RootViewController.m 


Let’s try tkis out … 
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the nav controller in action 




TesT DriVq 


Now that both views can talk to each other, go ahead 
and build and run. 


Tap bo wake 
drtail towc up. 




iirC^rfKf 


10:38 AM 


ii.CArTKf 


2 bZ P M 


E/lusic City Sunset 
Neapolitan 
Neon Geek 


[nqrRriiRnE 攻 : 


Lorem ipaum dolor siE er &\i 
lamot r conscctctaur dlllum 
adipi^erng pecu. do 
&iu$fYiQd teinpoF incididunt ut 


Polo Cockiail 


Purple Yummy 


□iroctions. 


U>rem ipsum dom siK er ehl 
laiTi£?t r consoc(e(aLir cHlium 
£Kiipl5Jcfflg pccu. ^ do 


Red Rudolph 


Rum 


Runner 


^usinod tejripor inadiaunE ut 


Sandbar 


Sleeper 


Strawberry Daiquiri 


TV/ c\\tV：\v\^ m i\\c I 

fields - k—oa 圹 d beta 

{\\Cjyc y^o\, edVt^Wc! 
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multiple views 


O 



So, now we can get to the detail view 
from the drink list, but there areiVt 
any details in there. We don’t have 
that info in our plist, do we? 


We’ve outgrown our array 

All that’s left is to get the ingredients and 
directions in the detail view, and we’ll have a 
bartender’s brain. To save you from having to type 
in the ingredients and directions, we put together 
a new file with all of the extra information. The 
problem is we can’t just jam that information into 
an array. To add the drink details to this version, 
we need a different data model. 



Which options below are possible ways to load the drink data? 


細⑽ 鉍 


Create a database with drink information 


Use dictionaries in our plist to hold the drink details 


Use an XML file to hold the drink details ~ Create multiple arrays in our plist 


Which of these options is the best for DrinkMixer? Why? 
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dictionaries store key-value pairs 



Which options below are possible ways to load the drink data? 


ExeRciSe 

畋 〆 d f " uS es -tV,e database, 沁寸如 

:: 以 ⑽ 秦 ，— 


a 

US a 


Create a database with drink information 


Use dictionaries in our plist to hold the drink details 


Use an XML file to hold the drink details 


Create multiple arrays in our plist ^ 

TW»s *,s feas^allv all o ? Ws 

一 ‘dUavc -akc su 代 -I 七， —a^/s W 
uf -to keep a sm^lc d^rnk skea^t 


Which of these options is the best for DrinkMixer? Why? Smdc wc already have Code writich *tha*t 
vises .p|is*b.,..y/.c. d .qwc • plist.ix>. .have. ar\ .ay：ray .o^. di^ipy)a.v：ies .ms-tead. 3r> ： ay. oi* . 

sty*m 3 s y/ithou*t 3 lo*t o-f c-f^o\rt ； This y/ay yit doh^ have to jr\*jty*odudc S^L or X^r: •?# 

>y^.d?. j.9?e ou-t the ，女 . 切 pi”5 • 孕 .deiici both S6^L a^d 

]X/yiL- dould ^ivc us. Sihdc this is a |C)r .xycVe *(x> .dictionaries. 


Pictiowaries store iwformatiow 


as key-value pairs 

Our current drink plist is just a single array 
of drink names. That worked great for 
populating the table view with just drink 
names, but doesn’t help us at all with 
drink details. For this plist, instead of an 
array of strings, we created an array of 
dictionaries. Within each dictionary are 
three keys: name, ingredients, and 
directions. Each of these have string 
values with the corresponding information. 
Since NSDictionary adopts the NS Coding 
protocol, it can be saved and loaded in plists 
just like our basic array from before. 
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iiereiare no o 

Dumb Questi9ns 


You keep talking about NSCoding. What is that? 

NSCoding is a protocol that works with the encoding and 
decoding of objects. Working with this protocol means dealing 
with how an object can be stored on disk or distributed throughout 
the device. For more information about NSCoding, see the Apple 
documentation. 


Q/ Where did the back button in the detail view come from? 
We didn’t do that... 

It's automatic functionality that comes with the navigation 
controller. When you added a title for the main view, the navigation 
controller kept track of that name as part of the view stack for 
navigation, and added a back button with the title in it. So yeah, you 
did do that! 



Ba 你 

■V 


Ope 


Go back to http://www.headfirstlabs.com/iphonedev and 
download DrinksDirections.pIst. It has a different name, so 
you'll need to make a couple of quick modifications. 



Open up the new plist in Xcode (again, in the resources directory), and 
look at what it comes with — all that data is ready to go! 



Go into the code and change the references from DrinkArray to 
DrinksD ire ctions. 




Tqst DriVQ 


Build and run to see the new plist, and watch what happens... 
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uh oh... 




TesT DriVq 
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Pebuggiwg — the dark side of 
iPhowc development 

Something has gone wrong, but honestly, this is a 
pretty normal part of the development process. There 
are lots of things that could cause our application to 
crash, so we need to figure out what the problem is. 


Warnings can help find problems without 
debugging 

In general, if your application doesn’t build, Xcode won’t 
launch it — but that’s not true for warnings. Xcode will 
happily compile and run an application with warnings 
and your only indication will be a little yellow yield sign 
in the bottom right corner of Xcode. Two minutes spent 
investigating a warning can save hours of debugging time 
later. 






Gee} Bits - 

Some common warning culprits:. 



Now that iPhone OS 3.0 is out, code that uses 
deprecated 2.0 properties triggers warnings. 



Sending a message to an object that it doesn’t claim 
to understand (from a typo or an autocompletion 
error) will trigger warnings. Your app will compile, 
but will likely end up in a runtime exception when 
that code is executed. 


That’s not our problem, though: our code should be 
warning and compile-error-free. The good news is that 
when an app crashes in the Simulator, it doesn’t go 
away completely (like it would on a real device). Xcode 
stops the app right before the OS would normally shut 
it down. Let’s use that to see what’s going on. 


Time lor some ctel>ug[g[ing[... 
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start with the console 


First stop oh your debugging 
advcwturc: the console 


We need to figure out why our app crashed, and thankfully, Xcode 
has a lot of strong debugging capabilities. For now we’re just going 
to look at the information it gave us about the crash, but later in 
the book we’ll talk about some of the more advanced debugging 
features. 


Since you ran the program in the simulator, the console should be 
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up. Here’s what ours looks like: 
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If you don’t see the console，we 
can get it for you! 

If you ran DrinkMixer in a different 
mode, or can’t find your console, in 
Xcode, go to the Run ~> Console menu option. 
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multiple views 


Interact with your application while 
ifs running 


The console is a very powerful debugging tool. Some of the best 
debugging techniques involve well-placed logging messages using 
NSLog(...). This information is printed into the console and can 
help you diagnose problems quickly. The console isn’t just read-only, 
though; it is your window into your running application. We’ll see log 
messages displayed in the console, and when your application hits a 
breakpoint, you’ll be placed at the console prompt. From there you 
can use debugging commands like print, continue, where, up, 
and down to inspect the state of your application. 
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^ >wovk hcvc. 


And when if s about to stop running 

In this case, we’re dealing with a nearly dead application, but the idea is the 
same. Since DrinkMixer has crashed, Xcode provides you with the basic 
information of what went wrong. In our case, an “unrecognized selector” was 
sent to an object. Remember that a selector is basically a method call — it 
means that some code is trying to invoke methods on an object and those 
methods don’t exist. 
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breaking it down 


Xcode supports you after your 
app breaks, too 

So far we’ve used Xcode to write code and compile and launch our 
applications. Its usefulness doesn’t stop once we hit the “Build and 
Debug” button. First, we can set breakpoints in our code to let us 
keep an eye on what’s going on. Simply click in the gutter next to 
the line where you want to set a breakpoint. Xcode will put a small 
blue arrow next to the line and when your application gets to that 
line of code, it will stop and let you poke around using the console. 
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multiple views 


The Xcode debugger shows you the state 
of your application 


The debugger shows your code and also adds a stack view and a window 
to inspect variables and memory. When you click on a stack frame, Xcode 
will show you the line of code associated with that frame and set up the 


corresponding local variables. There isn’t anything in the debugger window 
you couldn’t do with the console, but this provides a nice GUI on top of it. 
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Since we know that we’re having a problem near the 
array, try setting a breakpoint there. Then build and 
run and see what happens. 
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loading the array isn’t the problem 



TesT DriVq 


When you run it with the breakpoint at the point where you load the array, everything 
is OK: 
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DrinkMixer - Debugger Console 


- SirTkuldtur - - 

Orer 靴 《w 

f- rt y gwii fc Yrrq 1 ； ^ ^B > _ l | ! l tf uj'l uiy 


i 、 



，签 e — 

Build jnd Cu Tuhi Rc^[Jd[ Cu>iillmjc Dvdv.LlvjJ!：v 


») 


iDfltHB&D 


1 ia! m 1U3Q Dr i QkHl x»r [ 2A7 IA j 2Qb] * ■ * - [ iriVCFDlct Iqba ry 

iAK^UAlTo^tFinqi ： it uniri>e«rBli^d s 曇 lccE«r h-iidi LnatAiieii PKd.J:ftekiti 

I a: Sil 1 11£ h A Dr l QkHi mr [ 2A? 1A 』 2:'Qb」* ** Tfl trail nut trig .ipp duo to 
umcAU 霄 Hf> tficceptieji 'hhBVA lidArqui&$Dt£xecip(ioA' P nAE^nd *■ ■■ - 
(KSCrifleticDflry i a EquiiITa^trlTig : ] t uhtdc 时 dIe^I saet 

<tM.dLtrhQ' 

^Q3-Q^-2l lDt&S^7.-&Sl De-l.Dhm.xar[2D71 a^2Pb] Stuirk: { 

« »i ESpirtkU;Kifer ■ IMh^gvet 

_U 承 ^ w 

^rp driT Wvp ^lu a 





0(4^ 


滅: 


S^HIwliillf - JjD 


I Q I Pcip^ffl_* 

8=55 - 一 


wuim, 


Dcbw 


« rhrtid L IPnidP- I ： 

D 一 7Ill!MM ； TWGJWI_Ta_tK«UCHT_DKIF 

L , 1 ■ 1T !IFB 

^ -P^SnHiri 

i ^kvurd <n^ _ 

f >-*'j 1 !,isflI knTdir y 


A Tjt. 


■■ ” .ff u ,bi 

I' ■卢 


^rr 

vQ«iuJ1eiv ■ 

1 y^Vhnfil^Tjdpli V n wk_j nafl jt fuflBh^i^arrtCgl 『 bfC Mi jIIi 

t .-■'t ■t*rV*c»i 1 ,ij>Tj =*rV , v^Ij!i>'i : • rL*: 1 3 内 

BQ * : >MT 畢 blfl Vmb> Lap^uriu d%>l j 

1 L 'SltMjnn! Iff^rllaiSrivftry 
If r# tViffiiiiT riwru fipjTun^ 




Qmltm 


£^3i 

^rlt 


dniiw 

•MflM 


^il 


-l? i B Uk^V^Lzl^MsmMM^wih 4. 

& Is il J ^ fb ■ ■ d .Ai ■臞 k i -f ▲ U_fl, B ■ 

■€1|L - |c*feiL*..p- ㈣ 叫职 K _ 训 I 叫鹌 ， wUhfrs ⑷ l£d ， 凡 I" krj; 


C + 


M7Tjb|fV^r«^ 

|1 I (#11. wm njL] { 

IvLl ■ 1 1 lui ^iiti'iieVan^El L uK LvtT lniT'Hhl.liSlp'LBcyj PabhEVcr^sILiSvixCIcPiuLl rirhnirtldEf^T j ^ Lrr iti LI tficfil hf jh r| Bvl^rEtwivI : 


/f 私 _| 41ulTil fch« c-! 

"HTCTt ■- 

fESurp^ cjtLIs 


l" r ' [s-：!- ^ 〜 rt J rulAlI^tn 準笔 h G rvwfi 


C 


^fF r 4 > 4 l<V tp pME^QFt r^m kffH im ttaif 1 vjwri. 

.11 r I I U3TrtL»¥| a p« o-lil H alpVli F. i|| I _ > |4UIlpJh ， gn4i ： £P\prhi IKl-jpiPWh 4l4n44 ： dP#th 


CM WffffFiWWJ. 



What the heck is going oh? 

Our application is crashing, and it’s not at the array loading 
code. Open up the debugger and click on the topmost frame 
that contains our code. It will show you the line that’s causing 
the problem... see what’s wrong? 


To te continuect 籲參參 
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MultipleViewscposs 

Take what you’ve learned about the navigation 
controller and multiple views to fill in the blanks. 



Across 

3. The set of views that the nav controller deals with. 

6. Dictionaries use_to organize data. 

8. The screen that gives you output from the app. 

9. A template that combines a table view and nav controls. 

10. Has cells that need to be customized to work. 


Down 

1. A more versatile way to manage data beyond an array. 

2. DrinkMixer is this type of app. 

4. To use a new class you need to_it. 

5. The @ symbol is shorthand for creating one of these. 
7. A tool in Xcode to help fix broken code. 
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multiple views 



Your iPhone Toolbox 

You’ve got Chapter 4 under 
your belt and now you’ve 
added multiple views and 
the navigation controller to 
your tool-box. For a complete list of 
tooltips in the book, go to http://www. 
headfirstlabs.com/iphonedev. 
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MultipleViewscross Solution 

Take what you’ve learned about the navigation controller and 
multiple views to fill in the blanks. 



Across 

3. The set of views that the nav controller deals with. 
[VIEWSTACK] 

6. Dictionaries use_to organize data. [KEYS] 

8. The screen that gives you output from the app. [CONSOLE] 

9. A template that combines a table view and nav controls. 
[NAVIGATION] 

10. Has cells that need to be customized to work. [TABLEVIEW] 


Down 

1. A more versatile way to manage data beyond an array. 
[DICTIONARY] 

2. DrinkMixer is this type of app. [PRODUCTIVITY] 

4. To use a new class you need to_it. 

[INSTANTIATE] 

5. The @ symbol is shorthand for creating one of these. 
[NSSRING] 

7. A tool in Xcode to help fix broken code. [DEBUGGER] 
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5 pl!sts and modal Views 





So you have this almost-working app … 

That’s the story of every app! You get some functionality working, decide to add something 
else, need to do some refactoring, and respond to some feedback from the App Store. 
Developing an app isn’t griwttys ever a linear process, but there’s a lot to be learned in that 
process. 


this is a new chapter 
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debugging DrinkMixer 


It all started with Sam. 



for that? 


P\rihkMixc\r has two 
views ： a -table view of 
list a^d a de-tail view 
about ihdividual 
dvihk. I 


Sam wanted an app to make his bartending work 
easier. You got one up and rolling pretty quick, 
but hit a snag filling in the details for each drink 
because of a plist of dictionaries. 
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plists and modal views 



Am 
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Cras]i 


I 七 ^eidc it past 
loadihj -the 
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Id 七 ^Ohtihuc 

V"Uhhihg... 


DrinkMixer started and ran happily until it hit our breakpoint at 
line 20. The debugger stopped our application and displayed the 
debugging console. By setting a breakpoint in our code, what we 
discovered at the end of Chapter 4 is that before your app got 
to the commands to import the file, there was no crash; so far so 
good. 

Let’s walk through loading our plist and make sure that works by 
typing next twice. The first “next” looks up the path to the plist, 
the second one actually loads the data. 
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Succeeded 


Loading the plist worked fine; no problems there. The error must be coming after that. 
Let’s have the application continue running and see where it fails. Hit the Continue 
button (or type continue in the console)... and there’s our exception again. Where is 
this actually failing? 
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■ \ j«*c?f flBh 




Use the debugger to investigate the crash 


We can reliably get DrinkMixer to crash, and it doesn’t seem to be our 
plist loading code. Xcode has suspended our application right before 
iPhoneOS shuts it down, so we can use the debugger to see exactly what 
it was trying to do before it crashed. 

Switch back to the debugger and take a look at the stack in the upper left. 
This is the call stack that led to the crash. 


丁 he \rcd s-top sigh idoh will 
tcirmihatc youv- afpli^aiior 



了 7 … 3 io ^Oh-tihuc how 
^11 jus-t keep 4i|j h a _ 
^•hk/VJixc\r has bcch 
s-topped by iPhohcOS. 


n rn 


RjKrfVff^onti^lir m 料 - De buffer 


;iiPUJlCM ， 3.0 I Dfthifi 


'M -: 


a 


The buttohS aloh0 the 
"top o-P -the 
-Puhdtioh just like the 

but-fcohs ih the 乙 ohsole. 




Ik # . % ^ ^ iL 

■y^ debuii raui bujkn \t^pOmn lav tnc fipp Dm 


論 ■ 

|j t, 

B--M ftiialus^ni CwloS# 
■ 


^Ei ;:: 一 

fiH HP mls 
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plists and modal views 


’parpen your pencil_ 

^ Using what you’ve learned so far, figure out what’s going on! 

The exception talked about NSGF Dictionary. What dictionary is it talking about? Where is it coming from? 


Who’s sending messages to the dictionary? Why did we get an unrecognized selector? 


you are here P 


189 










square peg, round hole 


^Sbarp your pencil 


Using what you’ve learned so far, figure out what’s going on! 


tromr 


The exception talked about NSGF Dictionary. What dictionary is it talking about? Where is it cominj 

The did*tior\a\rics arc -fv-om plis*t| W\\tY\ y/c load plist, y/e r\oy/ have dh array o-f 

did*tioha\rics *ms*tcad ^y\ array of sbrm^s. 

Who’s sending messages to the dictionary? Why did we get an unrecognized selector? 

Messages arc bemg, scr\*t *bo -the did-tiohary y/c -tv-y *to srt *tKc dell’s label l*t’s ad*budlly -the 

label schdmj i*t a message fscc -the ” d siadk i*b Code m U|LalD>c|) : It^s se^clmj messages as 
■though -the dell label was a strm 今 . Bu 七 now weVc assi^'m^ a did*tiohary -to 七 he label 



WcYe trying to stuff a dictionary into a string 

Putting a dictionary into the text field of the label, which wants a string, 
isn’t going to work. Our previous array was an array of strings, so 
that code worked fine. Now that we have an array of dictionaries, we 
need to figure out how to get the drink name value (a string) out of it, 
and then assign that to the text label. If you take another look at the 
DrinkDirections.plist, you’ll see that we have an array of dictionaries — 
one for each drink. Dictionaries store their values using keys; they’re just 
a collection of key-value pairs. To get a value out, you simply send the 
dictionary the ob j ectForKey : @ n key" message. 


Instead o-P 


ins^cda o-r dssighmg the av-v-ay 
valy \righ-t -to the label, 
you II heed -to pull out the harrte 
value -P\rom the 
di^tiohav-y. 



somelabel.text 





Dictionary 


name = CupicT s 
Cocktail 

ingredients = 

Cherry liqueur f 
peach ... 

directions = 

Shake ingredients 
and strain into... 


Jfov •呼“ so 
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plists and modal views 


Update your code to handle a 
plist of dictionaries 

Armed with the knowledge of how the dictionaries are 
put together, we can use this information to populate 
the detail view, too. If you give the detail view controller 
the dictionary of the selected drink, it can populate the 
view’s fields before the view is shown to the user. 


^harpen your pencil 


Eadh di^-tiohav-y has 

r IOha,r y "to -the dai^sou^c 
W the detail view. 



Go ahead and make the changes to your app. After this, it should know 
that you’re using an array of dictionaries, not strings — and the detail view 
should have a reference to the drink it should display. Finally, the detail 
view should populate its fields before it appears on the screen. 


o 


❺ 


Change the way a table cell is configured. 

In RootViewGontroller.m, fix the cell’s textLabel.text property to use the 
name value from the appropriate dictionary. 


dbou 七七 he 

dotumCv>*ta*t*ioy> i-f you *to kmoYJ move 
dbou 七 did*tior>av**ics. 


Add a reference to a drink dictionary in the detail view. 

In DrinkDetailViewGontroller.h, add an NSDictionary* field named 
drink and the corresponding property declaration. 


o 


Add drink to the DrinkDetailViewController.m file. 

Synthesize and dealloc the new dictionary reference. 





A\cho^ ^ a 


tOY\ 
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updating for dictionaries 


^Sharpen your pencil 

Solution 


Go through the code and make sure 
that you’ve got everything right... 


// Configure the cell. 

cell.textLabel.text 

objectForKey : @"name"]; 

- 

return cell; 


[[self.drinks objectAtlndex:indexPath.row] 

_ Wse 邮办。心7 仫 ' 

d’6*t’ov\av7. 



RootViewController.m 


Qinterface DrinkDetailViewController : UlViewController 


NSDictionary *drink; 

工 BOutlet UITextField ^nameTextField; 

工 BOutlet UITextView ^ingredientsTextView, 
工 BOutlet UITextView *directionsTextView; 




©property (nonatomic, retain) NSDictionary *drink; 

@property (nonatomic, retain) UITextField ^nameTextField; 



DrinkDetailViewController.h 


Add dv'^k *to 

Qsynthesize drink, nameTextField, ingredientsTextView, 
directionsTextView; 


@implementation DrinkDetailViewController 



rinkDetailViewController.m 
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plists and modal views 



TesT DriVq 


Now that we’ve told DrinkMixer to deal with dictionaries, go ahead and build and run the app. 




It’s working again! Vow tlrat it’s not 
craskingf, it’s time to fill in tke details. 
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filling in the drink details 


The detail view needs data 



Cirrr* fiwII*- 

Afiar PMMf Um 


Now that you’ve figured out how to deal with 
dictionaries, it’s time to fill in the drink details. 
But getting the details out of the array of 
dictionaries to give to the datasource requires 
another step. 


丁 his is the ih-Pov-ma-tioh \y\ 

Dv-ihkPiv-c^tiohS.plist. 


View Controller 


TV)C 

(jia*t 3 sou\rC.C 
•m *bWis tasc 

IS i\\t fl'ist 


View Controller 


tW»s? Wc talked 
abou-t -bWis -tV)C 
sbruiy^t app- 





How are we going to get the information from 
DrinkDirections.plist into the app? 
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plists and modal views 


Each dictionary has all the 
information we weed 

Right now we’re just pulling the name of each drink into the app 
using the name key. In order to populate the ingredients and 
directions, we need to use the other keys. We could just type those 
right into our code, but we’re better developers than that, so we’ll 
pull them up into constants. The only thing left is getting the proper 
dictionary to the detail view controller so it can pull the information 
it needs. Go ahead and start setting everything up! 



The view controller needs direct access to the datasource, 
and the easiest way to get to that data is going to mean 
some quick code refactoring. 



Organize your dictionary constants to avoid bugs 

Since we’re going to need the name, ingredients, and directions keys in 
the view controller, we should clean up the code to start using real constants. 


Create a new file called DrinkConstants.h (File ^ New then choose Other 
and a blank file). Add constants (#de fine’s) for name, ingredients , and 
directions. Import DrinkConstants.h into DrinkDetailViewGontroller.m 
and RootViewGontroller.m. Finally, update the @"name" to the new constant, 

NAME KEY. 



Set the detail view controllers drink property 

After you instantiate the detail view controller when a cell is tapped, you need to set 
the drink property on the new controller to the selected drink. 



Add code to the detail view controller to populate the fields 

Before the detail view appears, the view controller should use the drink dictionary 
to set the contents of the name, ingredients, and directions components. 
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cleaning up with constants 


^EjcT- 


RciSe 

lyilOH 


Here’s all the added code to make the detail view work. 


o 


DrinkConstants.h 



EhinkCwixIdnli.h - DrinVMiip 

t 龜 


Ooiipft-a _ 

T'Ufi DnnhMi?icT 

W 1 'iglaiiii^i 

ii Ajo^iVltwOpfici^sl^rJh 
& hwIVifwCiinEigllfBjm 
h pTinifMiurrA|t|ifh^a^ejf- h 
u Dfin4cMi»4r.i.ppChta4Ji ： t.m 
ii PnnkbLui l M , iivC ； Dnlrall«i h 
DrinkPfu^^wCQnvBltfMTi 


Hhtm 



_ fkhn £a-urcvh 

ii DrlnkMi^tr Pr^h^jpfli 
mairun 
_ RjiAyrrci 

□fmknfKViEmi.piiit 

pCjjiJP^Ym^fHiJrpll，i mih 
lEFAlLTi 1 Kill 
PbmWindo^.^iCk 
DrinkArij^i pfn .1 
DrinkMiHtr-Inhs.B^x 


Tli inkF3v 
Rc^iV^wTan 
Nin&o^. 


► _i Fi JITWM 
_ * ISoduci-h 
> ^Tirgtci 


、.毒 LAnu^Jbici 

T| 9 1 Ffraii Mfl WjrniF^i 
， Fvnd R-Mulfi 

Iriiiilimja 

► liSCfct 

嘛 Pr&jtci 

. Mi ImpicmrnlaLEirini Flick 

一 H|Nm Flk-p 


DrinkDetailViewGontroller.m and RootViewGontroller.^botH need 

WcVc i\\t dittio^av-y 

keys *fco doy>s*tay>*U hcv-c- 


^import "DrinkConstants.h". 

Then add the constant to display the name: 


// Configure the cell. 
cell.textLabel.text = [[self.drinks objectAtlndex:indexPath•row] 


objectForKey:NAME 一 KEY] 
return cell; 


Change -this value -Pv-o» 




RootViewController.m 
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plists and modal views 


❺ Set the detail view controllers drink property 


// Override to support row selection in the table view. 

- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSInd 
exPath *)indexPath { 


// Navigation logic may go here -- for example, create and push 
another view controller. 

DrinkDetailViewController ^drinkDetailViewController = 

[[DrinkDetailViewController alloc] initWithNibName : Q^DrinkDetailViewContro 
ller” bundle : nil]; 


Ad? ihis whole lihe -to 
[self .drinks ^ ^ 


drinkDetailViewController.drink = 
objectAtlndex : indexPath.row]; 

[self.navigationController pushViewController : drinkDetailViewController 
animated:YES]; 

[drinkDetailViewController release]; 


a 


RootViewController.m 

❺ Add a method to the detail view controller to populate the fields 




Tf)is d e 

^od is 


- (void) viewWillAppear : (BOOL)animated { 

[super viewWillAppear : animated]; u 

nameTextField.text = [drink objectForKey:NAME_KEY]; 

ingredientsTextView.text = [drink 
objectForKey:INGREDIENTS 一 KEY]; 

directionsTextView.text = [drink objectForKey : DIRECTIONS 


DrinkDetailViewController.m 
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so thafs whaVs in a cupid’s cocktail! 




Tqst DriVQ 


Compile and build and run again. 



Dumb Questi9ns 


We re-create the detail view every 
time someone taps on a drink. Couldn’t I 
just reuse that view? 

For DrinkMixer it really won’t matter 
too much; since the view is pretty lightweight, 
we won’t suffer too much overhead re¬ 
creating it when a drink is tapped. However, 
for best performance you can refactor it to 
reuse the same detail view controller and 
just change the drink it should be showing 
when a row is tapped. 

Why did we have to pull out the 
dictionary key names into a separate file? 


Having magic string values in your 
code is generally a bad idea—no matter 
what programming language or platform 
you’re using. By pulling them up into 
constants using #define, they are checked 
by the compiler. So a typo like @”nme” 
instead of @”name” would end up as a 
bug at runtime, while mistyping NME_KEY 
instead of NAME_KEY would prevent things 
from even compiling. 

I looked at the NSDictionary 
documentation and there’s a 
valueForKey: and an objectForKey:. 
What’s the difference? 


Great question. valueForKey: is 
used for what’s called key value coding, 
which is a specific pattern typically used 
in Cocoa Binding. The subtle catch is that 
NSDictionary usually just turns a call to 
valueForKey: into a call to objectForKey, and 
it looks like either one will work. However, 
valueForKey actually checks the key you 
pass it and has different behavior depending 
on your key. That’s almost never what you 
want (unless you’re doing Cocoa binding 
stuff, of course). The correct method to use 
is objectForKey:. 
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Head First 

Lounge 



Sam, v-cady -fov- youv- 
app "fco make V^is 
ou\r) y/3llc*t fattd. 


Looks like tltere’s a market tkere! 
A ejuick submission to Apple aiut … 
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a modern-day dear john letter 


:::::: 

1 Apps rbfa^ r ^ fi r your iropleroentatton, 

1 Te^bmit your app &r ” 


Tir^C {/> 

'^vcs-tija-tc 
七 he W/^... 


Ilpsr 



We’ll go through the approval 
process later. 

Later in the book, we’ll take you step by 
step through the process of preparing 
an app for approval. For now, just worry about how to fix 
DrinkMixer! 
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It’s time to dive into the HIG and figure out what went wrong. 


When should we be using disclosure indicator elements? 


The HIG mentions detailed disclosure buttons and disclosure indicators — which should we use? Why? 


Wc have a usability problem 


We know that the user needs to touch the name of the drink 
to see the details about each individual drink, but how is 
the user supposed to know that? The HIG has a number of 
recommendations for how to deal with drill-down, hierarchical 
data. We’re already on the right track using table views but the 
HIG has a number of additional recommendations for helping 
the user understand how to navigate the app. 

Tabic tells V^avc a number built - m usability 

*,-terns i\\ai Keif users V\oy/ -to use 

youv app - even i-P it's vc 

r\AV\ it* 




To\aCM \\trt 


rteve is i\\t rooi Viom 七七 
usevs see, table v\cy/. 


View Controller 



-taps, i\\t view 

乙 oyrbrollcv" 

hands 

i\\t detailed 


vicy/- 



n 
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disclose your intentions 


It’s time to dive into the HIG and figure out what went wrong. 

When should we be using disclosure indicator elements? 

1^ \W6\f 0, -the a Table \/iew” sed-tio^, you pv-c*t*ty ^uidkly -fmd ou*t why 

youVc \ y \ violation over *tKosc disclosure mdidiltovs ： 

“The disclosure indicator element... is necessary if you’re using 
the table to present hierarchical information.” 

The HIG mentions detailed disclosure buttons and disclosure indicators — which should we use? Why? 

The disclosure mdida*bo\r demotes 七 ha 七 is ar\ dddi*bior\al level o-f ih-fo\rnaa*tior\ available dbou*b dh i*tcrw 

when you didk i 七 （like dr’mk details); i*t sclcd-b row and shows -the additional da*ta. The button 
do somethbesides select \roy/ - i*t ddh kidk of-f ad*tior\. Tha*t’s more y/dl Y\tt& here, so 
^11 jus*t y/ith *thc disdosu\rc mdide|*to\r ： 


■^Sharpen your pencil 

Solution 


- Ta^Je Cells Up Cl^se 

So, what exactly is the disclosure indicator element, and where does it go? 

Let’s look a little deeper in the HIG: 





^ VASC<i 


以工一 








n*t Irvfo 

detailed 


dc-tailTc^iLabcl - defe^dm^ ov\ 
whai ^11 siylc you use, it Cav\ show 
“p m d\((cytY\i places, -Po^-b, av\d 
Colons. 


d\s 6 \os^ md : 

avxd 


DrinkMixer uses really basic cells, but you can easily customize your cells for 
a different app, besides just adding disclosure indicators. Even though the 
table only supports one column, you can make it look like more by adding a 
thumbnail, for example. You can also adjust the font sizes to open up some 
room for each table cell if you need to. 

Most really polished apps use some kind of table cell customizing, so keep that 
in mind while you’re looking through the API. For now，we just need to add 
the disclosure icon to our cells to indicate there’s more information available if 
a user taps on them. 
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plists and modal views 


Use a disclosure indicator if your cell 
leads to more information 


TableViewGells have a lot of built-in functionality~we’re just 
scratching the surface. Adding a disclosure indicator is simply a 
matter of telling the cell what type of accessory icon it should use. 
Take a look at the UITable ViewG ell documentation for some of 



二 -二― 3 二 




n 


■“, ifc—.■ a-nl 


■i 






::二口二 ■ 


|| 




ir 


M tu _ 


the other options. 


fcjff 


Wc\rcs the 

匕。妁七妁七 you 

heed. 


There’s just one quick line of 
code to set the cell’s accessory 
type when we configure the cell: 



// 




Jus-t set the autssory type -to the 
Dis^losu\rc dohs-taht 


[[self.drinks objectAtlndex:indexPath.row] 


Configure the cell. 

cell.textLabel.text 二 
valueForKey:NAME_KEY]; 

cell.accessoryType = UITableViewCellAccessoryDisclosurelndicator; 

return cell; 





RootViewController.m 


Tost DriVq 


Go ahead and build and Run....make sure it’s working! 
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ready to resubmit to the App Store 




TesT DriVq 


One little line of code fixed all of your App Store approval issues. 



IWHij 

Drink Mix@r 


After DIdmif Mint 
Aftershock 

Apple 

Baked Apple 
B&e Stknger 
Beetle Juice 
Black Eyed Susan 
BlLhS Ocq 

Luck 


do! 
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plists and modal views 


This app is great! I’m 
going to use it every night. 



After resutmittingf to tke App Store, 
DrinkMixer is up on iTunes! 


Sales report - DrinkMixer - Week 1 
Overall sales - 400 downloads 


jus-t 

^ 0}r oy\t week/ 


Price-$1.99 

Overall revenue 


S796 ；： 


D eJttr A??' c 

㈣ a — c 

J 伽 s... 


Tke reviews are coming in … 
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meanwhile, back in the App Store 


Sales were going strong... 

But then bad reviews started coming in. What’s 
going on? 





Tiicy say -tWmy like 
ll pv-*mkMi%cv- sutb-l 
ca^i add 




y bar V)dS some 
ihks dy\d I dor!i ^v\i 
keef a sc^av-atc 

心 mks ^ro\AY\A- 


叩 m ^o*mg *to sy/rtdh *to iPvmk - 
•l 七 ’S move C%fClT>SlVC, bu 七 ••七 lets 
me add y>c>w dvmks dr>dl tus*tom*iz^ 
my list” 


w l do^-i like a^y o( 
"the dv-i^ks ov\ ihe 


J\v\oi\\tr \rcv'icv /： 
w | v\ttd ^ov-c 
i\\^Y\ ^0 dv’mks ” 


The 
reviews 
are bad. 


«■> 




WsV 1 
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^Sharpen your pencil 


Think about how you originally designed DrinkMixer and the 
feedback, and figure out what you’ll do next. 



What would address the users’ concerns? 



Given the structure of DrinkMixer, how would you refactor the code to fix the problem? 



Is there an easy way to fix the code? A hard way? 
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give the people what they want 


^happen your pencil 

Solution 


O 


Think about how you originally designed DrinkMixer and the 
feedback, and figure out what you'll do next. 


What would address the users’ concerns? 


The easiest way bo -fi% -the problem is to update tKc app so users cby} add drmks 
*to *thc list 


o Given the structure of DrinkMixer, how would you refactor the code to fix the problem? 

Wt 6ould ddd d view 七 ha 七 lets users errter 七 heiv drmk |*t 6ould look like 

jjr\t detail view, bu*t allow them to -type m *thcy Wolht l/VcM have *to be 

able *to save *m-fo\rr«a*tioh dhd update -the -table bo show -the dvmk. 


❺ Is there an easy way to fix the code? A hard way? 

There arc lo*b o-f hard v/ays ar\d fvobably a -fey/ good u casy w ways. general, -the 
easiest y/ay -for us *bo add *this -fuhd*tiohali*ty is *(x> reuse as mudh o-f wha*t v/c^vc already 
dor\e ds possible. IVe ddh dc-f*mi*tdy -take adva^-ta^c o-f our r\avi^a*tioh dorrbroller, ar\d 
let’s see i-f we dar /七 do somc-thrn^ use-ful wi*th our Dc*tailD\rmk\/icw *too … 





How would you go about implementing a view 
where users can add drinks to DrinkMixer? 
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plists and modal views 


APP MYOIJI CONSIRIJCIIOIX 1 / 

— — — — — — — — — — — — — — — — /； 




Here is the table view for DrinkMixer with two possible 
designs. Based on aesthetics, usability, and standard iPhone 
App behavior, which one is better for showing the users 
where they should add a drink? 

Some kihd but-fcoh ih the Add a -toolbar with some 

^vigatioh ^oh-tvollcv- -to k\ck 
d hew view. 


buttohs below the hav dohtv-ollcv. 


Captain and Cola 
Cal's mmw 
Cupids CocklHil 
Diay al the 
[lea^ Hunlsr 
FI rvcrflck.tr 
FSaming Merd 
■CUng 时 Man 
Key Vis si Lem DnadB 


Y^u’d have 

V"oorh -fo\r dh 

add but-fcoh 3 hd 
othev-s, whch you 
^ccd tilers. 


Option #1 


Option #2 


Which interface is better? 


Why? (Be specific.) 


Why not the other? 
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built-in buttons 


APP MYOIJI CONSIRIJCIIOIX 1 SOLUTION 


Here are two designs. Based on aesthetics, usability, and 
standard iPhone App behavior, which one is better for 
showing the users where they should add a drink? 


The hdvigatioh dohtvollcv 

匕 0 略 with buili-i h butioh 

suppov-fc. 



Drink Mixer 


Captain and Cola 
Oafs Meow 


Cu-pld s CacktBil 
a( th& B&ach 
Deer HunEBr 


Firecracker 


Flaming Merd 
■GUngorbr^ad Man 
Key Me si L&rrmnadE 


Option #1 






"This type of ihtc\r-Padc is opod wkeh 
you have several hew views -to add, 
J^o-t just OhC. \ 


Cal s Mecw 


Cupid s CocktsH 
Day al B&acn 
Deer HunEer 


Frccrack^r 


Flaming Merd 
Gmgofbf&ad Man 
Key Wfe si LernanadE 


Tiic 'toolbav* will 
to^cc uf f a\rt o-f 
{\\t -table View, -too- 


Option #2 


Which interface is better? Option #1. . 

why? (Be specific.) Bcdausc by *thc idoh m -the ” av doh*t\rollc\r # you doh^-t -take uj> rr>o\rc spade 

away. . 心抑七 iablc view.. TKcy-^s also. . 七 buiip^. }y>. ih?. .^v dohiirpjlcy ： .already ： 

Why not the other? Opiioh ^2. w\akcs -the .»r)i;cy*^ade a. bii. W%. fluttered, a^d \rc.<\M ,v ：? s . .^9^. ^pdc. 
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plists and modal views 


Use navigatioH controller 


buttons for editing 

So far we’ve used the navigation controller to move between views. 
But if you’ve spent much time with other iPhone apps, you know 
it’s capable of much more. Since a UITableView is almost always 
embedded in a navigation controller, table editing is usually done 
through buttons on the controller itself. Let’s start out by adding 
a + button to the navigation controller that will let the users add a 
drink when they tap it. 



Drink Mixer 


drop 


^irs will be dblc 

ihc + 

tu-t-toh -to add a 

dlrihk. 


^barpen your pencil 

l Icinn Yr 


Using Xcode, add the button to the Nav controller and 
the associated IBActions and IBOutlets. 


o 

❺ 



Open RootViewController.xib in Interface Builder. 

Scroll through the library and drag a Bar Button Item to the Main 
Window (this will add it to the list after the table view). It won’t show 
up on the navigation controller in Interface Builder — we’ll need to add 
code so it shows up at runtime. 

Add the IBAction, IBOutlet, and property declaration for 
addButtonltem. 

Just like any other button, we’ll have an IBAction for when it gets clicked 
and a reference to the button itself — all in RootViewG ontroller.h. 


\i ^ 

60 ^-tv-ollcv- ^ 

咖 w B r 

•、 s slMUUATtP, 

^ 0 *t v-cal- 



Add the synthesize, dealloc, and addButtonPressed method 
for addButtonltem. 

Synthesize the property, release the reference, and implement the 
addButtonPressed to log a message when the button is clicked — all in 
RootViewGontroller.m 



Finish up in Interface Builder. 

Open up RootViewController.xib again, and link the new Bar Button 
Item to the actions and outlets within the Main Window. 


Finally, pull up the inspector for the Bar Button Item and change the 

Identifier to Add. 
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add the button 


r ^^rpen your pencil 


V Solution 


Using Xcode, add the button to the nav controller and 
the associated IBActions and IBOutlets. 


o Open RootViewController.xib in 
Interface Builder. 

Scroll through the library and drag a 
Bar Button Item to the Main Window 
(it will get added to the list). 

^ Add the IBAction, IBOutlet, 
and property declaration for 
addButtonltem. 



Qinterface RootViewController : UITableViewController { 
NSMutableArray ^drinks; 

IBOutlet UIBarButtonItem *addButtonltem; 

} 

Qproperty (nonatomic, retain) NSArray ^drinks; 

©property (nonatomic, retain) UIBarButtonItem *addButtonltem; 
- (IBAction) addButtonPressed : (id) sender; 

@end 


o Add the synthesize, dealloc, and addButtonPressed 
method for addButtonltem. 



RootViewController.h 


synthesize drinks , addButtonltem; 





- (IBAction) addButtonPressed : (id)sender { 
NSLog(@"Add button pressed!"); 


L ^ % ^ -- 



RootViewController.m 
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plists and modal views 




self. 

navigationltem. rightBarButtonltem = 



put this inside 

self.addButtonltem; i/icwpidLoad 





- (void)dealloc 


[drinks release]; 

[addButtonltem release]; 

[super dealloc]; 



RootViewController.m 


Finish up in Interface Builder. 

Open up RootViewGontroller.xib again, and link the new Bar Button Item to the actions and outlets 
within the Main Window, right clicking and using the menus that pop up. 


Finally, pull up the inspector for the Bar Button Item and change the Identifier to Add. 
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Tost DriVq 


Go ahead; build and run the app … 
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button success 



Tesr DriVq 


Go ahead; build and run the app … 



■HrCJkrP 槪 


9 m PM 


Onnk Mpxer 


After Dinner Mint 


Aftershock 


Apple Martinr 


Baked Appm 
Bee Stinger 
Beetle JuEce 


Black Eyed Su&an 


Blue Dog 


Bookmakers Luck 


The button >wovks| 
Moyj you yt d 灼 

message 

*thc do 灼 sole … 




Tke tutton skows up in tke 
view, tut now wkat? 
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plists and modal views 


The button should create a new view 


Our new button works: the action gets called, but really doesn’t do 
anything useful yet. We need to give our user a place to enter the 
new drink information and we can do that with a new view. Just 
like with the detailed view, we can let the navigation controller 
handle the transition. 


…… 1 3 of 



⑽ 一 

dv'mk m-fo\rwat»oy>. 


p" —■ a ■ * r ■ 






AddDrink 
ViewG ontroller 



Root 

ViewG ontroller 





ViewG ontroller 






gulled ^ 

m-fovwat»o^ out vicv/ 

▲ 扣 d ’ 严 

pcta.IP^^Cv/Co^ollcr rub. 


What do we need for the user to be able to enter a new 


drink? Exactly what fields do you need and how will you 
lay them out? How will the view controller work? 


you are here p 215 
























































reuse your view 


We need a view... but wot necessarily 
a new view 


Our “new drink” view is really just an editable version of our 
detailed view. So instead of creating a whole new nib, let’s take 
advantage of the fact that the UI (the nib) is separate from our 
behavior (the UlView subclass in the .m file), and reuse the detail 



AddDrink 


DrinkDetailViewController.xib 


you didk oh 
these -text -fields, 
the keyboard will 
pop up ahd let 
you hCW 

iivPo\nrwatioh. 


view. 


Up until now we’ve had a one-to-one pairing between our nibs 
and our view controllers. That’s definitely the norm, but our view 
controllers are really just normal Objective-G classes. We can use 
object-oriented extension mechanisms like inheritance to add the 
behavior we want. 


^ Wd io suppov-t 

behavior -thah 

though. II hC cd a 
v ' cw ^oh*tv-ollcv-. 


TV^c add dv'mk V.cv/ r^ttAs 
^ same 

UAs as deta.l = 一，七 
•、us 七 ^ccds bo V>c 


Vie wC ontroller 



O 


Really, a new view controller 
but not a new nib? I thought 
they always go together. 


Not necessarily. 

Remember that a nib is just the XML representation of a view. Using 
nibs is a lot easier than trying to lay out your view using code. And since 
the nib is just graphical information, you need to put the actual code 
somewhere. That’s where the view controller comes in... 
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plists and modal views 


The view controller defines the behavior 
for the view 


From the user’s perspective we’ll have three views: the table view, the 
detailed view, and the new drink view. But, since we’re reusing the .xib 
to create the “new” view, all we need is a new view controller class that 
supports adding a drink. That means there isn’t any Interface Builder 
work to do at all! 


^ ^ •栋 a yub. 






7 


DrinkDetailViewController.m 


U 七 t 

dasc, Acids w 

(Jivmk iwfovwa 七， 


DrinkDetailViewController.xib 

T 

AtUts i),t ^ 
s\Ut V»cv/s ^>11 \ooY the 
sa^c, vcusc «t 





t ② 妙 :> 


AddDrinkViewController.m 


Separating tke UI from tekavior 
kelps you reuse your view. 



Reusing both the the nib file and the detail view 
controller is also an option... but where could we 
run into problems? 
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keeping track of outlets and actions 


A nib file contains the Ul 
components and connectioHS. 


One way we could reuse the nib is to create a new 
ViewGontroller and pass it the DrinkDetailViewGontroller.xib 
file when we initialize it. There are a few challenges with that, 
though. Remember, we don’t just use Interface Builder to lay out 
the interface; we use it to wire up the components to the class 



and information about the nib's File’s Owner 


that will load the nib. 

r i. V oWcv V>as W 产 

呼 r 〜 




f Pc5ilD\r*mk\/icwCoK\*tv*ollc\r ^ 
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The nib doesn’t actually contain the Vie wG ontroller class it’s setup up to be 
wired to. Instead, it does this through the nib’s File’s Owner. When you pass 
the nib to the view controller, it will deserialize the nib and begin making 


connections to the outlet names stored in the nib file. This means if we want to 


pass that nib into another, new view controller, we need to make sure we have 
the same outlets with the same names, the same actions, etc. 



Watch it! 


Because of the way DrinkMixer is built, we can just subclass our 
detailed view to get what we need. That works great for this app, 
but be careful doing this in more complex apps, because your code 
can get difficult to maintain. Often, it’s better to just bite the bullet and build a 
new view... and sometimes you’ll realize they shouldn’t even look the same. 


Reusing our nib gets us what we need for this app，but 
it’s not for every app out there... 
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plists and modal views 


You can subclass and extend views like 
awy other class 

Instead of reusing just the nib and having to re-create all of the outlets 
and actions, we can just subclass the DetailedViewGontroller and add 
the behavior we need. Our AddDrinkViewGontroller is the same as a 
DetailedViewGontroller; it just has the ability to create and save an entirely 
new drink. Everything else — showing the name，showing the description, 
etc. — are all exactly the same as the DetailedViewGontroller. 


,. 。 I DrEailDvmk\/icy/Coir>-bvollcv 

) IBOu-tlct UlTc%{P\c\d ^ cTc^-tFicId; 


a 代 pyotetted) so 






— (void) vicy/WillAffcav -： (BOOL) 





— (void) vic>wlVill/\ffcav -： (BOOL) aKtima'tecli 


l^l e behavi'^t t 

OVe 〜 ide a of methods. 


AddDv-'nrvkVicv/Coirrtv-ollcv 






vt 』 ask Vts su ? erdlass tv,e 

如 pe-ta»iP^^e>.Co^olle,.^. 


First, we neect to create tke new 
view controller. 
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when to reuse 


I still don’t get it about the new 
view controller without a new nib. 

There’s nothing in that nib that you 
couldn’t create in normal Objective-C by 
hand. As you’ve likely discovered with 
Interface Builder, nibs are generally a lot 
easier to work with than trying to lay out 
your view using code, so when you create 
a new view, you typically create a nib to go 
with it. But really, you could build an entire 
application without a single nib. 

In our case, we’re going to do something 
somewhere in the middle: we’re going 
to create a new view but reuse the Ul 
information from another view. 



Dumb Questions 

So why the “Watch it” warning 
about reusing the nib? Is this a good idea 
or not? 

Unfortunately, the answer is: it 
depends. For DrinkMixer, we can reuse 
our DetailDrinkView and its nib since we 
want the layouts to look the same and the 
DetailDrinkView doesn’t really do anything 
specific. However, in a more complex 
application, you might run into problems 
where you’re constantly fighting between 
the two view controllers or you have to 
expose so much information to the subclass 
that your code becomes unmaintainable. 

This isn’t a problem unique to iPhone 
development; you always have to be careful 
when you start subclassing things. 


For our app, subclassing works fine, and 
you’ll see it in some of Apple's example 
applications, too (which is part of the reason 
we included it here). But it’s equally likely 
that in some other application you'll want 
views to be similar, but not quite exactly the 
same. In those cases, create a new view 
controller and nib. 
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Use Xcodc to create a view cowtrolkr 
without a wib 

What we’ll do is create a new ViewGontroller in Xcode that 
doesn’t have its own nib, and then tweak it to inherit from the 
DetailDrinkViewGontroller. This new view will get all of the fields, 
behavior (which we’ll change), and the nib we need. 


^Sharpen your pencil 


Get into Xcode and create the AddDrinkViewController files. 



Create a new UIViewGontroller subclass named 
AddDrinkViewController without a nib using the New File, 
dialog. 


options m 

於 … dew 七 

y/ar\*t a y/'i*bVi *tV^c v*»cv/. 


Open up the new AddDrinkViewG ontroller.h file and change it to inherit 
from DetailedDrinkViewG ontroller instead of the UI Vie wG ontroller. 

Don’t forget to import the DetailedDrinkViewGontroller.h file. . 

add tv>e 

一 ed “ -鱗七 c ... 
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inherit the drink detail view controller 


•Sharpen your pencil 
蚊 Solution 


Get into Xcode and create the 
AddDrinkViewController files. 


In the File New dialog box, you need to create a new 

UIViewGontroller subclass files. Be sure to uncheck the i , , 

With XIB for user interface box ， since we don’t h ? use lie PctailDv-ihkl/icy/Coh-tv-ollcv-, 

need that .xib file. wc hCC irwpov- the headev so the Compiler 


khows what wcVc talkiq about 


#import <UIKit/UIKit•h> 

#import ''DrinkDetailViewController. h y 


@interface AddDrinkViewController : DrinkDetailViewController{ 

By dc-Pault ou\r view 

} do^iv-ollcv- mhcv-iicd -Pvorw 

@ end IWiewCoJvbrolleir. Change -that -to 

IV … kDeHiey/CoKrtvollev- hcv*c- 



The AddD e tail Vie wG ontroller. m file can 
stay exactly as it is generated by Xcode. 


AddDrinkViewController.h 


D 


tJiereia ： 

)umb 


are no o 

Questions 


Wait, why aren’t we just passing 
the nib into the AddDrinkViewController? 
Why all this subclassing stuff? 

We could do that, but the problem 
is we’re not just dealing with GUI 
layout. We have text fields and labels 
in there that need to get populated. Our 
DetailedDrinkViewController already has 
outlets for all of the fields we need, plus it 
has the functionality to populate them with 
a drink before it’s shown. We’d have to 
reimplement that in our new view controller if 
we didn’t subclass. 


Is this some kind of contrived Head 
First example or should I really be paying 
attention? 

You should be paying attention. This 
pattern shows up pretty often and a lot of 
Apple’s example applications use it. It’s 
very common, particularly in table-driven 
applications, to have one view that just 
displays the data and another to edit it when 
the user puts the table in editing mode (well 
talk about that more later). Sometimes you 
should use totally different views; sometimes 
you can reuse one you have. 


You mentioned that fields are 
protected by default. What if I wanted 
private fields in my class? 

It’s easy—just put @private (or 
@public for public fields) in your interface 
definition before you declare the fields. If 
you don’t put an access specifier there, 
Objective-C defaults to protected for fields. 
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Jim: Now we have an AddDrinkViewGontroller class, so all we 
have to do is push it on the stack like we did with the detail view ， 
right? 

Joe: That makes sense — we used the navigation controller to 
drill down into the data just by pushing a detailed view on the 
stack... 

Frank: Adding a new drink to our list is a little different, 
though. 

Jim: Why? 

Frank: Well, adding a new drink is really a sub-task. 

Joe: Huh? 

Frank: The users are stepping out of the usual browsing drinks 
workflow to create a new drink. 

Joe: Oh, that’s true. Now they’re typing, not reading and 
mixing a drink. 

Frank: Right, so for times like this, it’s important to 
communicate to the users that they have to complete the task. 
Either by finishing the steps or — 


Joe: — or by cancelling. 


Frank: So, what kind of view is that? 





Which of these views better communicates what the user 
needs to do? Is one more ambiguous than the other? 
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modal views are animated 


Modal views focus the user on the task at hand... 

When users navigate through your app, they are used to seeing views pushed and popped 
as they move through the data. However, some tasks are different than the normal drill¬ 
down navigation and we really need to call the users attention to what’s going on. iPhone 
does this through modal views. These are normal views from the developer perspective, 
but feel different to the user in a few ways: 
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View. 


Thc view is 


^ 义 t 二 


S T 


|fignid€i『Ct 






doctf an m tfif 




-Mmm uhun 


KlfKICrK] PKU S %W DC- 


MJVWI wtfmot 


ul 






仏 4/to. v “ 

bu ^ ihe h f ，乂 “ 






,_cr Umnrrr Hi 


Allersliock 


Appl# lilnrtlnl 


BaKod Apirio 


日 efi Stiver 


JuJc 


BIkX Ey_d Syu 


Blm Dag 


SoDkrPBkcr a 


L_ 




Lutb™ 


rpiiurn 


larr^c 




£rl ； i^ 5 * 4 l 


1 j 


QILTEmCC 








IM«Tq 


.：!： 


eiuimuti 




AHcr Dinner Mini 




BaKod 


Bee 5 tj 


中 __ 


职 f 


We’re going to use a modal view when users want to add a new 
drink to DrinkMixer. They have to either save the added drink，or 
discard (cancel) it，before they can return to the main DrinkMixer 
app. 
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plists and modal views 


Awy view can present a modal view 

Up until now we’ve presented new views using our navigation controller. 
Things are a little different for modal views: any UIViewGontroller can 
show a modal view, then hide it when necessary. To display a modal view on 
top of the current view, simply send the current view the presentModal 
ViewController : animated : message. Since our RootViewGontroller 
is the view controller that needs to show the modal view, we can just send 
this message to ourselves, using self, like this: 


[self presentModalViewController : addViewController animated : YES]; 


七 4c method. I 七 s simtlav -to 
-tWis *m Java ov C++- 



s is 七 dov^-tv-ollcv- 

L _ 七 A\s^td as a 
w, 'm ouv 'bV'C y'Ow 


f 7 ou sav NO bo a—a 七 cd, 

払 c _ jus 七 a^cavs. By ”” 
VBS, smooth slide m 

c bottom. 


-(•VOW {\\t 


— ^^rpen your pencil_ 

^ Update the RootViewController.m file to display our AddDrinkViewController in 
a UINavigationController when the + button is tapped. 


You’ll need to import the AddDrinkViewGontroller.h so the RootViewG ontroller 
knows what class you’re talking about. 


Change the addButtonPressed:sender: method to create an AddDrinkViewController, 
and present it as a modal view. Be careful about your memory management — don’t 
leak references to the controllers. 
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create your modal view 



Update the RootViewController.m file to display our AddDrinkViewController in 
a UINavigationController when the + button is tapped. 


#import ''DrinkConstants . h ; 

#import ''DrinkDetailViewController . h ; 


#import ''RootViewController . h 1 

一 


#import ''AddDrinkViewController • h 〃 J I 气 



RootViewController.m 


- (IBAction) addButtonPressed : (id) sender { 
NSLog(@"Add button pressed!"); 




like 七 
s a 


AddDrinkViewController *addDrinkVC = [[AddDrinkViewController alloc] in 
itWithNibName : @ 〃 DrinkDetailViewController 〃 bundle : nil]; 

[self presentModalViewController : addDrinkVC animated : YES]; 

[addDrinkVC release]; e 



Wow w C just h «d io show -the social view - 
m e Roo^cwCoh^ollcv is a (/icwCoh^ollcv, 

fhohe handles the ves-t. 


丁 $ Rootl/icwCoh-t\rollc\r will v-ctaih 3 
v-c-rcvchdc -to the hew view dohtv-ollcv- wheh 
: C P 代 it. -Povgct ijo v-clcasc 

the io the view Co^broW^I 




RootViewController.m 
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Tqst DriVQ 


Now that the add view is fully implemented, build and run the project. Make sure you 
try out all of the functionality: scrolling, drilling down to details, and finally adding a 
drink. Make sure you try adding a new drink name... 
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If your keyboard isn’t working, your 
fields might still not be editable. 

^ j . r . 11 Back in Chapter 4, we had you make the fields 
Wdl t/H 11* uneditable in Interface Builder. If your keyboard 

isn’t appearing, try going back into Interface 
Builder and checking that the fields are now editable. 


But wkat about 

after you finisk 
typing? 


you are here p 227 



























sam can't add his drink 


Thafs great, but after I type in 
the drink, nothing happens! I can’t 
get the view to go away, and I can’t 
add the drink. 




That’s a problem. 

Actually, it’s two problems that are related. 
The add drink detail view needs to go away 
one of two ways: either the user cancels out 
or saves the drink. We need to handle both. 
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plists and modal views 



How should we lay out the save and cancel 
buttons? 
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we need a navigation bar 


Our view doesn't have a navigation bar 


To be consistent with the rest of DrinkMixer, we really should put the save and 
cancel buttons at the top of the view in a navigation bar. The problem is, we 
don’t have one in our modal version of the detail view. 

Drink detail view 
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We could add one by hand, but remember we’re sharing the detail drink view 
nib, which gets its navigation bar from the navigation controller. Since we’re 
showing the add drink view as a modal view, we cover up the navigation bar. 

Instead of trying to solve this from within the detail drink view nib, we can 
embed our add drink view in a navigation controller of its own, like this: 




wc 


TWis W»ll add a ^av 

tor,bco\W -to ^ 

add dv'mk dcta»i 


UINavigationController *addNavCon = [[UINavigationController alloc] 
initWithRootViewController : addDrinkVC]; 


230 


Chapter 5 
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■ tMs? 




I 七 uses "t^C same *t°。. 


Allota-tc h\t UI Nav^atio^Co^tvollcv 

-(工 BAction) addButtonPressed : (id) sender { and pass m ou\r 

NSLog(@"Add button pressed!"); /\ddP/mk\/ie>MGoyj*brolle\r 

v-, C y/ (UmVoll 吖 .It V»ll 代 tam 払 e 

wbrolle\r, smte \i needs *to display it 

AddDrinkViewController *addDrinkVC = [ [AddDrinkViewController alloc] 
initWithNibName : @ 〃 DrinkDetailViewController 〃 bundle:nil]; 

UINavigationController *addNavCon = [[UINavigationController alloc] ini 
tWithRootViewControiler : addDrinkVC]; 

[self presentModalViewController : addNavCon animated : YES]; 

[addDrinkVC release] ; t AU w C just h «d io show ^ 一 

[addNavCon release] ; ' S| W Koo-tl/icwCohtvollcir is a 1/icwCohtvolUv 


-to please -to the 
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RootViewController.m 




It works! The modal view 
has a nav controller and 
your buttons have a home. 
Now we just need to create 
those buttons... 


you are here P 


231 













creating ui controls in code 


Create the save and cancel buttons 

Since both the save and cancel buttons need to dismiss the modal view, let’s 
start by wiring them up to do that. We’ll need some actions, and the buttons 
themselves. We’ve covered how to do that in Interface Builder, so we’ll write 
them in code this time. 


- (IBAction) save : (id) sender; 

- (IBAction) cancel : (id) sender; 


n ：l5：H beW 



Since we’re using the navigation bar, we get built-in support for left and right- 
hand buttons. We just need to create those buttons and assign them to our 
leftBarButtonltem and rightBarButtonltem to have them placed where we 
want them. 


AddDrinkViewController.h 


w 七 w “洲一⑽ 1 . 





- (void)viewDidLoad { 

[super viewDidLoad]; 

self.navigationltem.leftBarButtonltem 
alloc] initWithBarButtonSystemltem : UIBarButtonSystemItemCancel 
target : self action : @selector(cancel : )] autorelease]; 

self.navigationltem.rightBarButtonltem = [[[UIBarButtonItem 
alloc] initWithBarButtonSystemltem : UIBarButtonSystemItemSave 
target : self action : @selector(save : )] autorelease]; 

Uohu ouv w au-tov-clcasc w AddDrinkViewController.m 

to handle ^ - ^ it we ask 
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plists and modal views 


Write the save and cancel actions 

When the user clicks either Save or Cancel, we need to exit the modal 
view by asking the view controller that presented the view to dismiss it. 
However, to make things easier, we can send the modal view the dismiss 
message, and it will automatically forward the message to its parent 
view controller. Since the AddDrinkViewGontroller is the modal view 
and gets the button call back, we can just send ourselves the dismiss 
message and the controller stack will handle it correctly. We need to 
send ourselves the dismissModalViewCont roller Animated: 
message, like this: 

[self dismissModalViewControllerAnimated: YES]; 


u ^ +W.S coAt out save a^d 

da^cl mc^ods -to lo^ 二 f: C ’ 

「 於七』7心十心 dwk 


#pragma mark - 

#pragma mark Save and Cancel 






《tart this at the bot-fcom 

o-p tk -file, just bcW ihe 
deallod. 


(IBAction) save : (id) sender { 

NSLog(@"Save pressed!"); 

[self dismissModalViewControllerAnimated: YES] ; 

Sm 乙 C dve m *tV>C modal *this dismiss 

message Will be dkleyted uf *to our fair ⑶七 

v'icy/ do 於 * broilCV, y/iiidii Will 3£>*tu3lly make 七 he 
NSLog(@"Cancel pressed! ”) ； vk” 。 a>way. 


一 (IBAction) cancel : (id) sender { 


[self dismissModalViewContr oiler Animated : YES] 




AddDrinkViewController.m 


Vow, to see if tkose buttons work … 
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your modal view works 



TesT DriVq 


The modal view can be dismissed now, and the keyboard works too! 



This chapter, you’ve learned how 
to add a view and pass it through 
the navigation stack to pop the 
view, plus you reused the nib you 
already created and wired it up for a 
new use! Not only that, but your add view is 
modal, and you can dismiss it, too. 
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Congratulations, 
the modal view is 
orbing! 
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plists and modal views 


tWeiare no o 

Dumb Questi9ns 

Why don’t we need an outlet for the save/cancel button? And what about Interface 
Builder? 

The navigation controller API has support for both left and right buttons; you just need to initialize 
them with the buttons you want to use (save and cancel buttons, for instance). After that, all you need 
are the matching actions. 



To te continuect... 
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iPhonedevcross 



iPhoneDevcross 

Using all the stuff you’ve learned about how to work 
with different plists and views, fill in the puzzle... 



Across 

1. The navigation controller has support for_ 

buttons to fix stuff. 

5. Use these to organize names of things. 

7. Views can be_and extended like any other 

class. 

8. You can create_bars in the IB or in code. 

9. _is easier when the Ul is separated from 

the behavior. 

10. User_on iTunes stick with the app even 

after a new version is released. 


Down 

2. The HIG requires some kind of_element in a 

cell if there is more information availible. 

3. An_specifies what a button should look 

like. 

4. A nib file has Ul_. 

6. A_view has to be dealt with by the user before 

doing anything else. 
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plists and modal views 


Your iPhone Toolbox 

You’ve got Chapter 5 under 
your belt and now you’ve 
added plists and modal views 
to your toolbox. For a complete list 
of tooltips in the book, go to http://www. 
headfirstlabs.com/iphonedev. 
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be dismissed- 
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iPhonedevcross solution 



iPhoneDevcross Solution 



Across 

1. The navigation controller has support for_ 

buttons to fix stuff. [EDITING] 

5. Use these to organize names of things. [CONSTANTS] 

7. Views can be_and extended like any other 

class. [SUBCLASSED] 

8. You can create_bars in IB or in the code. 

[NAVIGATION] 

9. _is easier when the Ul is separated from 

the behavior. [REUSE] 

10. User_on iTunes stick with the app even 

after a new version is released. [REVIEWS] 


Down 

2. The HIG requires some kind of_element in a 

cell if there is more information availible. [DISCLOSURE] 

3. An_specifies what a button should look 

like. [INDENTIFIER] 

4. A nib file has Ul_■ [COMPONENTS] 

6. A_view has to be dealt with by the user before 

doing anything else. [MODAL] 


238 Chapter 5 










































































6 saving, editing, and sorting delta 


Everyone’s an editor". ♦ 



Displaying data is nice, but adding and editing information 
is what makes an app really hum. DrinkMixer is great—it uses some cell 
customization, and works with plist dictionaries to display data. It’s a handy reference 
application, and you’ve got a good start on adding new drinks. Now, it’s time to give the 
user the ability to modify the data — saving, editing, and sorting — to make it more useful for 
everyone. In this chapter we’ll take a look at editing patterns in iPhone apps and how to 
guide users with the nav controller. 


this is a new chapter 
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sam's new drink 


is ready fo add a 六 _ a 七七 ^ l 。 哼 

Red-Headed School 


Sam went to try DrinkMixer with the new add 
view, and ran into problems right away. 


S 3 w v/ 3 s 
dl'»6k 


I»dkm5 aro^d^ - 

tsdy add 

Wis r\t^ dv'»^k. 



TV^c d\rtt {: \oi\s, 
jf ield is Kidder 
u 灼 dev 七 ^ 
kc^koavd- 



We have a problem with our 
view, since we can’t get to 
some of the fields. 



-the 
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saving, editing, and sorting data 


...but the keyboard is m the way 

We’re back to the keyboard problem we saw earlier with InstaTwit. 
When Sam taps on a control, it gets focus (becomes the first 
responder) and asks iPhoneOS to show the keyboard. Generally, 
that’s a good thing. However... 


，吩 d 以 











j 3D I 


S 0 B 0 QQQ 




M had a similar problem 
,h ( hS 七丁 wit wheire the usev 
^ouldh^t get io the ^ohtv-ols 
uhdev -the keyboard. 











How did we deal with the keyboard last time? Will that work this time? 
What do you want the view to do when the keyboard appears? 
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scroll view up close 



How did we deal with the keyboard last time? Will that work this time? 
What do you want the view to do when the keyboard appears? 


Rcsi<xy\*m(\ -first rcspohdcv worked las 七 PrmkMi>cc\r i*t y/ould be -f mc -for *the -field, but 

•參 • • • • • • • •••»«••••••• 癱 1 ****«*«*«««««««««»««_«_ •«••••• •參••參 ••••••••••••••••• •癱•參 •■參 

wha*t about 七 he div-ed*tio^s dr\d *the m^v-edich-ts -fields? f[s sooy\ as -they keyboard domes up, -thcyVc 
dovcrcd Thc user has 為 smalle\r sdrcch *bo work y/i*tK or\tt *the keyboard shows up — wc r\tt& *to set up 
*thc viow *bo scroll -thmjs m y/hch 七 he user heeds We ddh do {\\\s wi 七 h a UlScrollView- 



XJI^cpallView xJp Cl^se 


UlScrollView is just like the basic UlView we’ve been using except that it can handle having items (like 
buttons, text fields, etc.) that are off the screen and then scroll them into view. The scroll view draws 
and manages a scroll bar, panning and zooming, and what part of the content view is displayed. It 
does all of this by knowing how big the area it needs to show is (called the contentsize) and how 
much space it has to show it in (the frame). UlScrollView can figure out everything else from there. 


Co^i ^ 
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Scroll 1 /icw 


Remember, in GocoaTouch, components are subclasses of UlView. All a scroll view needs to care 
about are the subviews it has to manage. It doesn’t matter if it’s one huge UllmageView that shows a 
big image you can pan around, or if it’s lots of text fields, buttons, and labels. 

To get a scrollable view, we need to move our components into a UlScrollView instead of a UlView. 
Time to get back into Interface Builder... 
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saving, editing, and sorting data 


Wc need to wrap our content in a scroll view 

We want the user to be able to scroll through our controls when the keyboard 
covers some of them up. In order to do that, we need to add a UI Scroll View to 
our view and then tell it about the controls (the content view) we want it to handle. 
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(mrnus i\^t ^ ^oU 


This is really annoying. You mean we 
have to pull all those components 
off and then lay out the view again? 
Isn’t there an easier way? 


You’ve got a point. 

Remember when we said sometimes 
Interface Builder makes things (a lot) 
easier? This is one of those times... 
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scroll view construction 


EASY GUI RECONSTRUCTION 


Apparently we aren’t the only people to realize after 
we’ve built a view that it needs to be scrollable. 
Interface Builder has built-in support for taking an 
existing view and wrapping it in a UlScrollView. 


* on 


Drink 
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Highlight all of the widgets (as shown here) in 
the detail view, then go to the Layout ^ Embed 
Objects In ^ Scroll View menu option. Interface 
Builder will automatically create a new scrolled 
view and stick all the widgets in the same 
location on the scrolled view. 
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Interface Builder will create a UlScrollView just big 
enough to hold all of our components. Since we want 
the whole view to scroll, grab the corners of the new 
UlScrollView and drag them out to the corners of the 
screen, right up to the edge of the navigation bar (we 
don’t want that to scroll). 





How will this new scroll view know how much 
content needs to be scrolled? 
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saving, editing, and sorting data 


The scroll view is the same size as 
the screen 

Interface Builder created the UI Scroll View, but there are a few 
finishing touches we must do manually to make this work the way 
we want. We need to tell the UI Scroll View how big its content 
area is so it knows what it will need to scroll. We do that by setting 
its contentsize property. You’ll need to add an outlet and 
property for the UI Scroll View, then wire it up in Interface Builder 
so we can get to it. 

So how do we figure out how big the contents ize should be? 
When the UI Scroll View is the same size as our screen, we don’t 
have anything outside of the visible area that it needs to worry 
about. Since the scroll view is the same size as our UlView that it’s 
sitting in, we can grab the size from there, like this: 

scrollView.contentSize = self.view.frame.size; 

Once you’ve added that line, you’ll have a scroll view that takes up 
all of the available space, and it thinks its content view is the same 
size. 
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Sharp your pencil 


Update DrinkDetailViewController.h and DrinkDetailViewController.m to 
handle our new UlScrollView. 



Add an attribute named scrollView to DrinkDetailViewGontroller to hold a 
reference to the UlScrollView. You’ll need the field declaration and IBOutlet property, 
then you will synthesize it in the .m and release it in dealloc. 



Wire up the new property to the UlScrollView in Interface Builder by adding a new 
Referencing Outlet to the UlScrollView connected to your scrollView property. 



Set the initial contentSize for the scrollView in viewDidLoad:. Remember, 
we’re telling the scrollView that its content is the same size as the view it’s sitting in. 
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start scrolling 


^Sharpen your pencil 

Solution 


Update your DrinkDetailViewController.h and 
DrinkDetailViewController.m to handle our new UlScrollView. 



Add an attribute named scrollView to DrinkDetailViewGontroller to hold a 
reference to the UlScrollView. You’ll need the field declaration, an IBOutlet property, 
synthesize it in the .m and release it in dealloc. 


(^interface DrinkDetailViewController : UlViewController 
NSDictionary *drink; 

IBOutlet UITextField *nameTextField; 

IBOutlet UITextView ^ingredientsTextView; 
IBOutlet UITextView *directionsTextView; 

IBOutlet UlScrollView* scrollView; 




Qproperty (nonatomic, retain) UlScrollView* scrollView; 





七一 sc 七如 

•m vieviPuiLoad. 


DrinkDetailViewController.h 


Qsynthesize scrollView; 


OlcdV) Up OUV* 

i h dcalU. 




(void)viewDidLoad { 

[super viewDidLoad] ; 
scrollView.contentSize = self.view, 
frame.size 



- (void)dealloc { 

[scrollView release] 

[nameField release]; 

[ingredientsTextView 
release]; 



DrinkDeta 


— 〆 

ilViewCc 


Controller.m 
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saving, editing, and sorting data 



Wire up the new property to the UI Scroll View in Interface Builder. 
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Tap in tke text fieU 
anct tke keyboard 
appears... tut notliing’s 
scrolling! 





Why isn’t it working yet? Think about all the things 
that you have going into this view — the scroll view, 
the main view, and the keyboard... 
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keyboard means changes 



Sd\roll 


view 


...WUb 如 a??«a^ 

d 仫 ㈣ c stroW ^ rt 
V, as less s ? a6c ^ ^ 


iPhone tells you about the keyboard, 
but doesn’t tinker with your views. 

Just because iPhone knows that the keyboard 
is there, it doesn’t know how your app wants 
to handle it. That’s up to you! 


// 你 lax 


The keyboard changes the visible area 

The problem is the keyboard changes the visible area but the scroll 
view has no idea that just happened. The scroll view still thinks it has 
the whole screen to display its content, and from its perspective, that’s 
plenty of room. We need to tell the scroll view that the visible area is 
smaller now that the keyboard is there. 
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iPhone notifications 


iPhowc notifies you about the keyboard 

Interacting with the keyboard and the scroll view brings us to a part of 
the iPhone OS we haven’t talked about yet, called Notifications. Just 
like component events being passed around our application, there are 
system-level events, called Notifications, that are being passed by the 
iPhone OS. The secret to knowing what’s going on with the keyboard is 
tapping into these events. 



Sam taps in the Drink 
name field and the 
field becomes the first 
responder. Now the 
iPhone OS needs to show 
the keyboard. 


❺ The iPhone OS posts a 

notification to the default 
NSNotificationGenter named 
UIKeyboardDidShowNotification. 


Event 

Object 

Selector 

UIKeyboardDidShowNotification 

DetailDrinkViewController 

keyboardDidShow 











NSNotificationCenter 



The N SN otificationG enter 
invokes the target selector 
and passes it information 
about the object that 
triggered the event, along 
with event specific details. 



[registeredObject 
keyboardDidShow:eventInfo]; 



N SN otificationG enter looks up the 
event to see if anyone is registered 
to be told when that event happens. 
Objects are registered by providing a 
selector (method) to call if the event 
is triggered. 
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saving, editing, and sorting data 


Register with the default wotificatiow 
center for events 


The iPhone OS supports more than one NSNotificationCenter, but unless 
you have specific needs for your own, you can just use the default system-level 
one. You can get a reference to the default one by calling: 

[[NSNotificationCenter defaultCenter]; 

With the notification center, you can register for events by passing the object 
you want the notification center to call back to (usually yourself), the method 
to call, an event you are interested in (or nil for any event), and, optionally, 
the sender you want to listen to (or nil for all senders). 





[[NSNotificationCenter defaultCenter] addObserver : self selector : @ 
selector(keyboardDidShow:) name : UIKeyboardDidShowNotification object : nil]; 



叫 砂 as 

then UMrcgister when youYc done 


Just like memory management, we need to clean up our registrations from 
the notification center when we don’t need them any longer. We’ll register for 
events in viewWi 11 Appear: and unregister in viewWi 11 Disappear:. 
Unregistering for an event is easy~just ask the notification center to 
remove Ob server for the object you registered. 

[[NSNotificationCenter defaultCenter] removeObserver:self]; 



3S 
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notification know-it-all 



The centev 

This week’s interview: 

Why do you talk so much? 


e 印 ©sei 


Head First： Um, this is embarrassing but I’m not 
entirely sure I have the right Notification Center 
here... 

Notification Center： Well, unless you need 
something weird, it’s probably me. I’m the guy 
everybody goes to by default. Heads up! An app’s 
shuttin’ down. Be with you in a second. 

Head First： Wow — so you know about every app 
that starts and stops? 

Notification Center： Yup. I’m the default center; 
all the system events go through me. Now, not 
everybody is interested in what’s going on, but if they 
want to know, I’m the guy to see. 

Head First： So when someone wants to know 
what’s going on, they tell you what they’re interested 
in, right? 

Notification Center： Exactly. If somebody wants 
to know about somethin’ in the system, they register 
with me. They tell me the notification they want me 
to watch for, who I should tell when it happens, and, 
if they’re really picky, who should have sent it. 

Head First： So then you tell them when that 
notification happens? 

Notification Center： Right 一 they tell me what 
message to send them when I see the notification 
they were interested in. I package up the notification 
information into a nice object for them and then call 
their method. Doesn’t take me long at all; the sender 
almost always waits for me to finish telling everyone 
what happened before it does anything else. 

Interviewer： Almost always? 

Notification Center： Well, the sender could 
use a notification queue to have me send out the 
notifications later, when the sender isn’t busy, but 
that’s not typically how it’s done. 


Head First： Hmm, this sounds a lot like message 
passing. The sender wants to tell somebody that 
something happened, you call a method on that 
somebody... what’s different? 

Notification Center： It’s similar to message 
passing, but there are some differences. First, the 
senders don’t need to know who to tell. They just 
tell me that something happened and I’ll figure 
out if anyone cares. Second, there might be lots 
of people interested in what’s going on. In normal 
message passing the senders would have to tell each 
one individually. With notifications they just tell me 
once and I’ll make sure everyone knows. Finally, the 
receiver of the notification doesn’t need to care who’s 
sending the message. If some object wants to know 
that the application is shutting down, it doesn’t care 
who’s responsible for saying the app’s quitting, the 
object just trusts me to make sure they’ll know when 
it happens. 

Head Rrst: So can anyone send notifications? 

Notification Center： Sure. Anybody can ask me 
to post a notification and if anyone’s registered to get 
it, I’ll let them know. 

Head First： How do they know which notifications 
to send? 

Notification Center: Ah, well that’s up to 
the sender. Different frameworks have their own 
messages they pass around, you’ll have to check 
with the framework to see what they’ll send out. If 
you’re going to be posting your own notifications, 
you almost certainly don’t want to go blasting out 
someone else’s notifications; you should come 
up with your own. They’re just strings — and a 
dictionary if you want to include some extra info — 
nothing fancy. 

Head First： I see. Well, this has been great, 
Notification Center. Thanks for stopping by! 
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parpen your pencil_ 

Fill in the blanks and get a plan for the next step! 


We need to 

for the , 

and 

events in 

We’ll add two 

that will be called by the 


when the notifications are posted. 

We’ll adjust the size of the when the keyboard appears and disappears. 


We need to 

for events in 
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sharpen solution 


r ^^rpen your pencil_ 

Solution 

Now you have a plan for what to do next. 

We need to ... . r^Ur. . for the UJ^cyboavdDi dShow/V o*ti-fi^a*tioh 

and events in 

We’ll add two r^c-jtKods that will be called by the ho*ti*fid3*tioh 

when the notifications are posted. 

We’ll adjust the size of the scroll view when the keyboard appears and disappears. 

We need to uhvc^is-tcv- for events in vicwl/Vi 11 Disappear 


Q/ I can’t find the list of notifications 
that are sent by the iPhone OS. Where are 
they listed? 

There isn’t a central list of all the 
notifications that could be sent. Different 
classes and frameworks have different 
notifications they use. For example, the 
UlDevice class offers a set of notifications 
to tell you about when the battery is being 
charged or what’s happening with the 



proximity sensor. Apple's documentation is 
usually pretty clear about what notifications 
are available and what they mean. The 
keyboard notifications are described in the 
UlWindow class documentation. 

Why would I want to create my own 
notifications? 

It depends on your application. 
Remember, notifications let you decouple 
the sender from the receiver. You could use 


this in your application to let multiple distinct 
views know that something happened in your 
application. 

For example, let's say you had a view 
that let you add or remove items from 
your application and your app has several 
different ways to view those things. 
Notifications could give you a nice way 
to announce to all of the other views that 
something has changed without your add/ 
remove view needing to have a reference to 
each of them. 
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ExeKclSe 


Go ahead and make the changes to your code to register 
for the keyboard events. We’ll implement the code to handle 
the scroll view shortly. 



Add keyboardDidShow and keyboardDidHide methods to the 
AddDrinkViewController. 

For now, just have them print out an NSLog when they are called. We’ll add 
the meat in a second. Both methods should take an NSNotif ication ^, 
as they’ll be called by the notification center and will be given notification 
information. 



Register for the UIKeyboardDidShowNotification and 
UIKeyboardDidHideNotification in viewWillAppear(...). 

You should use the default NSNotificationG enter and register to recieve both 
events regardless of who sends them out. 



Unregister for all events in viewWillDisappear(...). 

A stub for this method is included with the template, but it’s commented out by 
default. Go ahead and uncomment it and add the code to unregister for events. 



Add a BOOL to AddDrinkViewController that keeps track of 
whether the keyboard is visible or not. 

We’ll talk more about this in a minute, but you’re going to need a flag to 
keep track of whether the keyboard is already visible. Set it to NO in your 
viewWillAppear (…） for now. 
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ExeRciSe 

Soiy-tiOH 


Go ahead and make the changes to your code to register 
for the keyboard events. Well implement the code to handle 
the scroll view shortly. 


Thcsc ^ both methods 4^ the 


- (void)viewWillAppear : (BOOL)animated { 

[super viewWillAppear : animated]; 

NSLog(@"Registering for keyboard events"); 

[[NSNotificationCenter defaultCenter] addObserver : self selector : 
selector(keyboardDidShow:) 

name:UIKeyboardDidShowNotification object:nil]; 

[[NSNotificationCenter defaultCenter] addObserver : self selector : 
selector(keyboardDidHide : ) 

name : UIKeyboardDidHideNotification object : nil]; 

// Initially the keyboard is hidden, so reset our variable 
keyboardVisible = NO; M- - N 

} We y\ttA to keep brack o-f wKctKcv tKc keyboav-d is 
o\r y>o*t- Moyt oy> "this m 3 




- (void)viewWillDisappear : (BOOL)animated { 

NSLog(@"Unregistering for keyboard events"); 

[[NSNotificationCenter defaultCenter] removeObserver:self]; 

} 

- (void)keyboardDidShow:(NSNotification *)notif { 

NSLog(@"Received UIKeyboardDidShowNotification."); 

} 

- (void)keyboardDidHide : (NSNotification *)notif { 

NSLog(@"Received UIKeyboardDidHideNotification."); 

} 

AddDrink 


ft! 


AddDrinkViewController.h 


@interface AddDrinkViewController 
BOOL keyboardVisible; 


DrinkDetailViewController { 


- (void)keyboardDidShow : (NSNotification*) notif; 

- (void) keyboardDidHide : (NSNotif ication*) notif; - w 

AddDrinkViewController.h 
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Keyboard events tell you the keyboard 
state and size 


The whole point of knowing when the keyboard appears or 
disappears is to tell the scroll view that the visible area has changed 
size. But, how do we know the new size? The iPhone OS sends out the 
keyboard notification events (UIKeyboardDidShowNotification and 
UIKeyboardDidHideNotification) when the keyboard appears and 
disappears and includes with this event all of the information we need. 


6owCS YiVO a ^ 




iheire 


name = UIKeyboardDidShowNotification 


'NSNotification 1 
object 




object = relevant object or nil 



userlnfo 



〜如 Yefoo^A so 
J W\ ^ s6vo\\ 

V\CYi 如 心 VlSlV>1C 







JOh h 




SrcB- 


Tke keytoarct size is 
in tke NSNotification 
otject. 



Getting the notification is easy, but we get told every 
time the keyboard is shown, even if it’s already there. 

That’s why we need the BOOL to keep track of whether or not the 
keyboard is currently displayed. If the keyboard isn’t visible when we 
get the notification, then we need to tell our scroll view its visible size 
is smaller. If the keyboard is hidden, we set the scroll view back to full size. 


you are here ► 257 




















keyboard magnets 


Ke^toarJ Code Magnets Part I 

Below are the code magnets you’ll need to implement the 
keyboardDidShow method. Use the comments in the code 
on the right to help you figure out what goes where. 


CGRect viewFrame 


self.view.frame; 


viewFrame.size.height 


keyboardSize.height; 






=v iewFrame 

YES; 


NSLog(@" Resizi 




v i 3 ibl e . 啡试响 ^ 

return; 


NSPictionary* i nfo 


[notif 


userlnfoj 


258 Chapter 6 










saving, editing, and sorting data 


II The keyboard wasn't visible before 


// Get the size of the keyboard. 



// Resize the scroll view to make room for the keyboard 


AddDrinkViewController.m 
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keyboard magnets 



Ke^toarti Code Magnets Part II 

Below are the code magnets you’ll need to implement the 
keyboardDidHide method. Use the comments in the code on 
the right to help you figure out what goes where. 



if 一 

return; 


• Ignoring notification.) 


NSPictionary* info 


[notif 


userlnfoj 




dBoundsUserlnfoKey ]； 


CGRect viewFrame 


SGlf •view.frame; 


viewFrame.size.height += keyboards!ze.height 
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- (void)keyboardDidHide : (NSNotification *)notif 


// The keyboard was visible 


// Get the size of the keyboard 


// Reset the height of the scroll view to its original value 




AddDrinkViewController.m 
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keyboard magnets solution 


Ke^toard Code Magnets Solution 

Below are the code magnets to work with the keyboard... 



(void)keyboardDidShow : (NSNotification *)notif 

if (keyboardVisible) { 

NSLog(@"Keyboard is already visible 
return; 


Ignoring notification .’’）； 


// The keyboard wasn f t visible before 


NSLog(@"Resizing smaller for keyboard") 


// Get the size of the keyboard. 


NSDictionary* info = [notif userlnfo]; 


Wc will tW»s 

uscv sy/Vt^cs 'ted 

^.clds, cv ⑼ keyboard is 

alv-cady sV^oy/'m^. So vjc keef *bratk 
\i and ba*»l *»Vs a repeat 

didtiohairy with -the cvch-t 
details ； wc pull 七 hat out he^e. 


NSValue* aValue = [info objectForKey : UIKeyboardBoundsUserlnfoKey]; 
CGSize keyboardSize = [aValue CGRectValue]•size; ’ 

^ 9 ^ keyboard si^ 

Worn -the di 匕 "tiohavy... 

// Resize the scroll view to make room for the keyboard 


CGRect viewFrame = self.view.frame; 
viewFrame.size.height -= keyboardSize.height; 


scrollView.frame = viewFrame; 
keyboardVisible = YES; 


,.{\\cy\ -fijuv-c ou*t iioy/ b'15 
scroW view v-cally is y\o>n fbasi 乙 ally 
b'13 our v'icv/ »s, w>’mus 
-f i\\c keyboard). 


SIZjC 


pmally> ufda*tc sdvoll viev/ Wi 七 h *tV>c 
siz^ a 於 d mark 七七 tKc keyboard is visible. 



AddDrinkViewController.m 


262 Chapter 6 




















saving, editing, and sorting data 



Ke^toard Code Magnets Part II Solution 

Below are the code magnets to work with the keyboard... 


Handling the UIKeyboardDidHideNotification works almost exactly the same way, except 
this time the scroll view needs to be expanded by the size of the (now missing) keyboard. 


- (void)keyboardDidHide : (NSNotification *)notif 


if (!keyboardVisible) { 

NSLog(@"Keyboard already hidden. Ignoring notification.^); 

A I . •• L WI ， 

return; / 




// The keyboard was visible 



// Get the size of the keyboard. 


NSDictionary* info = [notif userlnfo]; 






// Reset the height of the scroll view to its original value 


CGRect viewFrame = self.view.frame; 
viewFrame.size.height += keyboardSize.height; 



scrollView•frame 
keyboardVisibl© 





AddDrinkViewController.m 
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scrolling works now 




TesT DriVq 


Go ahead and build and run. Once you get into the detail view, you should be able to 
scroll the view to the right field, and the messages in the console help you keep track of 
what’s going on. 





Srimulplar - 3 -fl j 



Ptprx#4 


U I _U 及 h 

_tmifl Jirt 14 血 


扣 



-M-LL Da- LnUi urriAii^i 1^1 Ud Inttnn 

wdl 


t&W *T4M\M 

2D4]f<HH-LL 3i.j-l4i J1.ID3* &r LnbMd urfHJiiLii i 34&| 
aul 2mr for knffacurd 






Manipulating that scroll view size is 
kind of tricky—how would I have figured 
that out without magnets? 

A great reference for the code 
samples and information for programming 
apps in general is the iPhone Application 
Programming Guide that is available on the 
Apple developer website. That has sample 
code for common problems like handling the 
keyboard events, using the GPS, etc. 

Tell me again why we need to keep 
track of whether the keyboard is already 
visible? Isn’t iPhone doing that? 

The iPhone OS knows the state of the 



keyboard, but it sends keyboard events out 
when different controls get focus. So, when 
the user taps in the first field, you'll get a 
UIKeyboardWillShowNotification followed 
by a UIKeyboardDidShowNotification. When 
the user taps into another field, you’ll get 
another UIKeyboardDidShowNotification so 
you know they keyboard focus has changed, 
but you won’t get the keyboard hide event, 
since it never actually went away. You need 
to keep track of whether you already knew 
it was visible so you don’t resize the scroll 
view to the wrong size. 

The scroll view works, but 
depending on what the users pick, they 
still have to scroll to the widget? 

Yes—and that’s not ideal. You can 


ask the scroll view to scroll to a particular 
spot on the content view if you keep track 
of which control has the focus. The iPhone 
Application Programming Guide has good 
sample code for that. 

Do we really need to use the 
keyboard size stuff in the notification? 
Isn’t it always the same? 

It's not always the same! If your 
application is landscape, your keyboard is 
wider than it is tall. If your app is portrait, 
then it’s taller than it is wide. Apple also 
makes it clear that they may change the 
size of the keyboard if necessary and you 
should never assume you know how big it is. 
Always get size information directly from the 
keyboard notifications. 
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Everything scrolls OK, and I can put a drink in, but 
as soon as I get back to the list, ifs gone! 



Sam’s drink is missing! 

As soon as he leaves the drink detail view, the new 
drink no longer shows up in the main list. We need 
to figure out how to keep it around longer... 



Sharpen your pencil 




Answer the following and think about 
what it means for our app. 


What happens to new drinks when the user hits save? 


Where do we need to add code? 


How are we going to save the new drink? 

. a . 
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create a MutableDictionary 



Parpen your pencil_ 

^ Solut^fln Answer the following and think about 

一 “ J what the answers mean for our app. 

What happens to new drinks when the user hits save? ^Vlc dismiss tKc view tKc dvrnk *m-fovma*tior\ 
is lost. 

Where do we need to add code? \Nt y\tt& to ddd some Code *to tKc sdve method "that dd'budlly s-fco\rcs 

ih? 如 user chtcycd. 

How are we going to save the new drink? Smdc.wc aljrcady.s^o)rc ouv ： . dy-i|r\ks m.didiipr\a\r.i(C.s,. wc. Cay\ . 

dycatc a. hc.y/. djjt*tipha\ry m^p\rrir\a*tip^. dhd .add.ii .ip 与 yr^/:. 



We can create a new dictionary by allocing 
it, but were going to need to get a reference 
to the array from somewhere. Could the 
RootViewController help with that? 


We need to give the AddDrinkViewController a 
reference to the whole drink array. 

Creating a new NSMutableDictionary is easy enough, we 
can do that by allocing and initializing it. We can set the drink 
on the dictionary using thesetOb j ectForKey : . What’s 
going to take a little more work is adding it to the drink array. 
We could have the RootViewController pass the new drink in 
after we’ve created it... 
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Go back and update the RootViewController and AddDrinkViewController to 
support saving new drinks. 



Give the AddDrinkController a reference to the master drink array. 

You’re going to need to add a field to the class, a property, and then synthesize 
it and release the reference in dealloc. Finally, you need to make sure that the 
RootViewController passes on a reference to the drink array when it’s setting up the 
AddDrinkController. 



Create and add a new dictionary to the array. 

You need to update the save: method to get the drink details from the controls and 
store them in a new dictionary. After that, add the dictionary to the master drink 
array using addOb j ect : . 
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exercise solution 


1% 


* Go back and update the RootViewController and 

AddDrinkViewController to support saving new drinks. 

§OL|it»OH 


Qinterface 

AddDrinkViewController : DrinkDetailViewController{ 
BOOL keyboardVisible; 

NSMutableArray *drinkArray; 




一 二 e 


awa'f so ^ 

} drmk \3*tcv* 

©property (nonatomic, retain) NSMutableArray* drinkArray; 


AddDrinkViewController.h 


-( 工 BAction) addButtonPressed : (id) sender { 

NSLog(@’’Add button pressed !’’）； 

AddDrinkViewController *addDrinkVC = [[AddDrinkViewController alloc] initWithNi 
bName:@”DrinkDetailViewController" bundle : nil]; 


UINavigationController *addNavCon 
tViewController:addDrinkVC]; 


[[UINavigationController alloc] initWithRoo 


addDrinkVC.drinkArray = self.drinks 


[self presentModalViewController : addNavCon animated:YES]; 
[addDrinkVC release]; 

[addNavCon release]; 


fysit our r\cwly cxtdktA AddPv-'mk\/»cwCojr>*tv-ollcv- 
a *to master dwk array W 讪⑺ 

七 he usev* adds a dv*»r\k. 





RootViewController.m 
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AddDrinkViewController.m 




- (IBAction) save : (id) sender 
NSLog(@"Save pressed!"); 


Sihdc wc waht -to add 

*to d mutable didtiohav-y. What 
problems dould you \ruh ih-to latcv- i-f you 
^\rca*tcd immutable vcvsioh? 


Id keys 3hd objc^"ts ; 
table didtiohav-y. \N 


II Create a new drink dictionary for the new values 
NSMutableDictionary* newDrink = [[NSMutableDictionary alloc] init]; 
[newDrink setValue : nameTextField.text forKey : NAME_KEY]; 

[newDrink setValue : ingredientsTextView.text forKey : INGREDIENTS 一 KEY] 
[newDrink setValue : directionsTextView.text forKey : DIRECTIONS KEY]; 


// Add it to the master drink array and release our reference 
[drinkArray addObject: newDrink] ; kcV 

_ W— aW ， 


[newDrink release]; 


^ a ''° 6 ^ ' 


dvmk a 叫 . 


// Then pop the detailed view 
[self.navigationController dismissModalViewControllerAnimated : YES]; 


- (void)dealloc { 

[drinkArray release ]; 

[super dealloc]; 




••矚身， _ 一 _ _ _ ■ 


■相 


AddDrinkViewController.m 
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five-minute mystery 


龜 

^olc, ircady io 
WL JK P^^pcir hc^* VIP 

卜 3^s. 


Plve^lnute 

My^ry 


The Case of the Missing Reservations 



Nicole has been a Maitre d’ at Chez Platypus since it opened 
nearly 10 years ago. This upscale restaurant has a number of 
distinguished customers who like their dining experience to be 
just perfect. The VIP guest list hasn’t changed in years and Nicole 
knows everyone’s face. She sends them right to their favorite table 
when they show up and makes sure everything is just right. She’s 
extremely efficient and the restaurant couldn’t do without her... 
that is, until her recent, tragic, mistake. 

Earlier this month Chez Platypus got a new investor. A 
prominent if eccentric Nobel Prize-winning scientist who is 
known for his particular tastes. Restaurant management dug up 
the dusty VIP list and added the scientist’s name at the bottom, 
along with all the detailed instructions for making sure everything 
was “just so” when he arrived. They trusted that Nicole would 
would take good care of him and didn’t give it another thought. 

Last night, their new investor arrived a few minutes before some of 
the other VIP guests. Nicole didn’t even notice him. She continued 
to move the regular VIPs to their seats and, for all she knew, their 
new investor did not even exist. 


Why mould Nicole ignore such an 
important nezv guest? 
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Tesr DriVq 


That was a lot of code! Run the app and make sure everything is 
working. Here’s a drink to add to the list (it’s the new house drink 
in the Head First Lounge). 


-this -to 
youir app.. 



如 cf - teicfed School Girl 


Md thc ^ soda h> a 

shot glass ahd dHhk. 
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test drive 



Tesr DriVq 


To properly test the app now, click the add button and enter the data for the new drink in the 
detail view. When you’re finished, click save. 

Now, what happens back in the list view? 





DAnflclinn wl^k^y 
Cream 




qqqqSOD 43 


,?123 


return 








But your ctrinlc 
still isnt 9 there! 
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peW 吻 M 


Something’s wrong. We implemented the save method, created a new 
drink, added it to the array... and we’re pretty sure all that code works. 
Before we move on, let’s use the debugger and do a quick sanity check. 
Uncomment the viewWillAppear in RootViewController.m and set 
a breakpoint. Click “Build and Run” to start the application... 
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What did you find? 


What’s going on? 
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exercise solution 




E^eRciSe 

SotyivOH 


peW 吻 M 


Now we’re going to use the debugger to help us 
figure out what’s going on. 







you y/a^-t \p see m cadh d*idtioy>a\ry you day> use iW\s to^^A *m -the ⑽ sole: 

p (char*) [[[self.drinks objectAtlndex : 0] ob jectForKey:@"name ] 


UTF8String] 


ft r« 
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The Case of the Missing Reservations 
Solved 


Why mould Nicole ignore such an important neiAJ 
guest? 

Nicole hasn’t needed to look at the VIP list in 
years. She was so concerned that their important 
customers feel welcome that she didn’t want to 
have to do something as crass as go back and read a 
list every time someone arrived. She made a point of 
memorizing that list so when they came to the restaurant she 
could recognize and seat them immediately. As far as Nicole knew ， 
there were 10 VIPs on that list and she knew them all. 



Plve^lnute 

Mystery 


The problem was that the list was changed and no one told her. All 
it would have taken was a simple “heads up” to Nicole that there 
was a change to the list and the restaurant’s newest investor wouldn’t 
have disappeared... along with his money. 
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table view data changes 


The table view doesn't know its 
data has changed 


The table view does a number of things to improve 
performance as much as possible. As a result, if you just 
change values in the datasource without telling it, it won’t 
know that something has changed. In our case, we added a 
new value to the array used by our datasource but didn’t let 
the table view know about it. 



^Oh*tv"ol ICV" modified 

dvmk used by 




View Controller 


You need to ask the table view to 
reload its data 


… b “ 七 cvc\r "told 七 h 

tabic view ii happened. 


t 


Since we’re modifying the underlying data used by the datasource, 
the easiest way to refresh the table is to ask it to reload its data. You 
do this by sending it the reloadData message. This tells the 
tableview to reconstruct everything — how many sections it thinks it 
has, the headers and footers of those sections, its data rows, etc. 



RootViewController.m 
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Tesr DriVq - 

Update your RootViewController.m to tell the table view to 
refresh its data before the tableview is shown, and let’s try 
adding a new drink again. 
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saving works! 



Tqst DriVQ 


To properly test the app now, click the add button and enter the data for the new drink in the detail 
view. When you’re finished, click save. 

Now, what happens back in the list view? 




^kJOurar ^ lam fm 


unnaniifin 
Cream socfa 




?123 


return 




Sav/C >CYX 
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saving, editing, and sorting data 


tJiereiare no ^ 

Dumb Questi9ns 


Telling the table to reload all its 
data seems pretty drastic. Is that really 
how I should do it? 

It’s the simplest way to refresh the 
table data, but not necessarily the most 
efficient. It depends on what you're doing to 
the table. If you’re modifying the table while 
it’s visible, you can call beginUpdates 
and endUpdates to tell it you’re about 
to make a number of changes and it will 
animate those changes for you and let you 
avoid a reloadData call. There are 
also versions that only reload the specified 
rows or for a given section. Which you use 
depends on your application, how much you 
know about what changed in your data, and 
how big your dataset is. 


We didn’t add any code to the 
cancel button. Don’t we have to do 
something there? 

Nope—the cancel button is coded to 
just dismiss the AddDrinkViewController. 

This will clean up any memory associated 
with the controller and throw away any data 
the user entered in the fields. As long as 
we don’t manipulate the drink array, we’ve 
properly canceled any action the user 
started. 

Why can’t I see the drink 
information in the debugger when I 
expand the drinks array and dictionaries? 

This is one of the disadvantages 


of using a generic class like 
NSMutableDictionary for storing 
our drinks. The debugger knows the class is 
a dictionary, but that’s about all it can tell us, 
since all of the keys and values are dynamic. 
You can get to them through the debugging 
console, but that’s not as convenient as 
seeing real attributes on classes when you 
debug something. 

Did we really need to use the 
debugger back there? Couldn’t I have just 
printed out how many items were in the 
array using NSLog? 

Sure, but then you wouldn’t have been 
able to practice debugging again …： -) 



Uhh—that drink is 
at the end of the list, 
not in with the Rs. 





Look back at our debugging work. Why is the drink 
showing up at the bottom of the table? What do we 
need to do? 
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sorting arrays 


The array is out of order, too 


Our table view gets its information directly from our drink array. 
In fact, we just map the row number into an index in our array 
in cellForRowAt IndexPath:. 


RooWicv/Co^-tv-ollcv-.m 



Wc caw sort our array using NSSortPcscriptor 

In order to get the table view properly sorted, we need to sort our data 
array. NSSortDescriptors can do exactly that. You tell descriptors what 
to compare by specifying a property, how to compare them with an 
optional selector, and then which order to display the information in. In 
our case, we’re looking for alphabetical sorting by the name of the drink. 


value U a„a 7 . ，s ^ t 

be 七 cw 叫 c have •»” 如今 s ? 0 1 

away - 一 ch/, 。炚， d/mk. 




° h dHhk har^es. 


// Sort the array since we just added a new drink 

NSSortDescriptor *nameSorter = [[NSSortDescriptor alloc] 
initWithKey:NAME— KEY ascending:YES selector : @selector(caselnsensitiveCompare 
：)]； _ 

[drinkArray sortUsingDescriptors : [NSArray arrayWithObject:nameSorter]] 
[nameSorter release]; \ 


To do sort, ly ask i\^t 各叫」 
{jo sori itscl-f ouv 


|.f provide a scIcdW, \i does a 

tasc-sc^srtWc domfav-ison, but wc a 

tasc-*mscns*i*tWc oy\C 


Add "this \v\ -the save rwethod a-Picv- you add 七 he ^ 

da*t3 "to -the avray bu 七 bc-Po\rc "the viev/ yts popped 
o(( 七 he s-tadk. 
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Tesr DriVq 





6o6kta»» ^'ass a^d 


Add the sorting code to AddDrinkViewController, then 
run the app. Let’s add another drink; this one should 
end up in the right place. 




Great, that new drink is there, 
but what about the Red-Headed 
Schoolgirl from before? Don’t we need 
to deal with saving more permanently? 


All our data is lost when we quit... 

We’re positive we’re updating the array with our 
new drink, but obviously that new array doesn’t 
survive quitting and restarting our app. 

What do we need to do? When should it happen? 
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when to save 



Jim: OK, so we should save the array after each new drink is 
added, right? That will make sure we always have the right data. 

Frank: Not so fast. Keep in mind the whole speed/memory 
management thing. 

Joe: What’s the problem? It’s just a little array. 

Frank: But that means you could be saving out every time you 
add a drink. 

Jim: Oh, I see, that means we’ll have to go through reading in the 
array and saving it back out multiple times. That does seem like a 
waste. 

Joe: Well then, when are we supposed to do it? 

Frank: When we exit! The app will keep the data present until it 
closes, then it’s lost without some kind of save. 

Jim: How do we do that? How can we tell when the user exits? 

Frank: Hmm... what about that applicationWillTerminate 
method on our app delegate? 

Joe ： But the app delegate doesn’t know anything about our drink 
list or where to save it... 


Frank: Good point. The UIApplicationDelegate says there’s a 
notification that goes out too. I bet we could use that... 


D 


theveictr 

)umb 


e no o 

Questions 


What notification tells us the 
application is quitting? 

The iPhone OS will send out an 
UlApplicationWillTerminateNotification before 
your app exits. 

Do I need to register to receive it? 

Yup—just like any other notification. 


What if the user hits the home 
button or the phone rings or...? 

Anytime your application exits normally, 
either through your code or the user hitting a 
button or something else triggers the iPhone 
to switch applications (like a phone call 
the user decides to answer), you’ll get the 
applicationWillTerminate. There’s really only 
one case where you won’t … 


What happens if my app crashes? 


Then you’re not going to get the 
notification. The data would be lost in this 
case. You need to balance how critical 
it is to make sure no data is lost with 
the performance impact of saving more 
frequently. In our case, we’re just going to 
save on exit. 
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saving, editing, and sorting data 


Sharpen your pencil 


O 


❺ 


Use your skills at working with the API and what Jim, Frank, 
and Joe were discussing to figure out what to implement 
to save the array. Update your RootViewController.m and 
RootViewController.h to handle saving. 


Add the code to save out the new plist of dictionaries. 

Implement the method that will be called when the 

UIApplicationWillTerminateNotification is sent to save the plist. We’re going to give 
you a little code snippet to use. This code will only work on the simulator, but we’ll 
revisit this issue in Chapter 7. 

NSString *path = [[NSBundle mainBundle] 

pathForResource : @"DrinkDirections" ofType : @"plist"]; 

[self.drinks writeToFile : path atomically : YES]; 


Register for the UIApplicationWillTerminateNotification. 

We know that the applicationWillTerminate : method will be called on the 
AppDelegate when the application shuts down, but our RootViewGontroller 
really owns all of the data. Have the RootViewG ontroller register for the 
UI Application WillTerminateNotification just like the AddDrinkVie wG ontroller 
did, except add the registration and unregistration code to viewDidLoad and 
viewDidUnload, respectively. 



This code will only work in the simulator! 

The code used to save the plist will work fine on the simulator, but fail 
miserably on a real device. The problem is with file permissions and where 
apps are allowed to store data. We’ll talk a lot more about this in Chapter 7, 
but for now, go ahead with this version. This is a perfect example of things 
working on the simulator but behaving differently on a real device. 


Watch it! 
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sharpen solution 




parpen your pencil 

Solution 


Use your skills at working with the API and what Jim, Frank, 
and Joe were discussing to figure out what to implement 
to save the array. Update your RootViewController.m and 


RootViewController.h to handle saving. 


Add "this *to vicy/DidLoad. 


RootViewController.m 


// Register for application exiting information so we can save data 

[[NSNotificationCenter defaultCenter] addObserver : self 
selector : @selector(applicationWillTerminate : ) 
name : UIApplicationWillTerminateNotification object:nil]; 


Do^*t *to "this \y\ Roo-t\/ic>wCo^*tv"olIc\r bo< 


(void)applicationWillTerminate : (NSNotification *)notification 
NSString *path = [[NSBundle mainBundle] 

pathForResource : @"DrinkDirections" ofType : @"plist"]; 
[self.drinks writeToFile : path atomically : YES]; 


Add this *to vicy/DidU^load. 


n*is is i\\t Code tWs jomj *to jWc us problems oh 
a veal dcvitc. We'll tW»s ajam (a^d \t) ^ 

Y\t%i Rafter — bear us \or now"" 



284 Chapter 6 












saving, editing, and sorting data 




TesT DriVq 






… W,// 

^ 9^pe. 


The stop and “Build and Run” in Xcode are NOT the same as the home 
key and relaunching the app in the simulator! 


* r I l/l//7en you stop the app using Xcode’s stop button, you are killing the app right then 
It * and there. No termination notifications are sent, no saving is done — it’s just stopped. 
Likewise, when you click Build and Debug, Xcode will reinstall the application on 
your device before launching it To test our load and save code, make sure you restart the app by 
tapping the icon in the simulator. 


rtcvc » s ! 


Make suv-c you 
P\r*mkM*i%c\r i\\t time you 

*bap oy\ *bV^c \Cov\ m *tV^c simulatovi 
dcm’*b Wrt Build ad Pcbuj aja'mf 


Authov s hotc ： wc thought about showing the 
same sdveehsho-t twi 祀 but ^iguv-cd that st.il 
广 uldh 七 firovc that it saves a-Plcv- hittma 

"the Kome key ba 匕 k ih. 
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no dumb questions 


ihereictre no ^ 

Dumb Questi9ns 


So arrays know how to save 
themselves... Can I just put any object in 
there and have it save to a plist? 

No —not just any old object. 

Arrays load and save using a Cocoa 
technique called NSCoding. Any objects 
you want to load an save must conform 
to the NSCoding protocol, which 
includes initWithCoder and 
encodeWithCoder method— 
basically, load and save. You’d need to 
conform to the NSCoding protocol and 
provide those methods to be serializable in 
and out of an array. However, NSDictionaries 
do conform to NSCoding (as do the strings 
inside of them), and that’s why we can load 
and save so easily. 

Q/ What is the deal with giving us 
code that won’t work on the device? 

What happens? 

Well, to find out what happens, we 
encourage you to run it on a real device. 
Then think about why it isn’t working the way 
you’d expect. We’ll talk a lot more about 
this in the next chapter. To give you a hint, it 
has to with where we’re trying to save the 
data. This is also a real world example of 
something working just fine in the simulator 
only to behave differently on a real device. 
You always need to test on both. 


Instead of registering for that 
quit notification, couldn’t we have just 
updated the AppDelegate to get the drink 
array from the RootViewController and 
save it in the delegate? 

Yes, you could. It’s more of a style and 
design question than anything else. Right 
now the AppDelegate doesn’t know anything 
about our plist, our drink array, or even the 
RootViewController, for that matter (other 
than making it visible). You could argue we’d 
be breaking encapsulation if we exposed 
what needs to be loaded and saved for each 
view up to the AppDelegate. Since we only 
need to save a single array, it’s not a big 
deal either way, but if you have a number 
of views that need to save information or 
complex persistence code, it can often be 
cleaner to leave it with the class that needs 
to know about it rather than lumping it all 
into the AppDelegate. Technically speaking, 
though, either one would work. 

Why did we register and unregister 
in the viewDidLoad and viewDidUnload 
methods instead of the *Appear 
methods? 

The problem is when and 
how often those methods are called. 
viewWillAppear is called whenever 
the view is about to be shown. That starts 
out OK—well get that call before the table 
view shows up and we can register. However, 


the viewWi 11 Disappear will 
be called right before we show the detail 
or add drink view controllers (since our 
RootViewController is about to be hidden). 

If we unregister there we won't get the 
termination notification if the user decides to 
quit while looking at the details for a drink. 

For example, say the user adds a new 
drink, goes back to the RootViewController 
then taps on his drink to make sure he 
entered it correctly. We show the detailed 
view, he’s happy, then he quits the app. Our 
RootViewController has unregistered for 
the termination notification and the drink is 
lost. Instead, we use the load and unload 
methods, which are called when the view is 
loaded from the nib or unloaded. Since that 
view is in use throughout the application, 
those won’t be called except at startup and 
shutdown. 

What’s the deal with hitting “Build 
and Run" versus tapping on the icon to 
start DrinkMixer the second time? 

It's because of how we’re saving the 
data. We’ll talk more about it in the next 
chapter, but the problem is when you hit 
"Build and Debug,” Xcode compiles and 
installs the application onto the simulator. 
This means it’s replacing the modified drink 
plist with the one that we ship with the 
application and you lose your drink. Which, 
everyone can agree, is very, very sad. 
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saving, editing, and sorting data 



Thafs great! Now I can add the extra 
drinks I need. But there are a couple of 
other things that I need to really make this 
app work for me. 


o 


Delete drinks that aren’t used to 
keep the list small and easy to use. 


❻ 


Edit the ingredients for drinks that 
were already in the list. 





How can we implement these things? Where 
in the app do we need to handle this stuff? 


you are here ► 


287 








table views supprt editing 


Table views have built-iw support for 
editing and deleting 

Good news! The table view comes complete with almost everything we 
need for deleting data. This is behavior that acts a bit like implementing a 
save or cancel button, and a lot of it comes preloaded. 


Editing mode adds an edit button to the navigation control in the main 
view, and when it’s pressed, indicators appear to the left of the table cell 



that can be selected and deleted like this: 


delete \toy^ ^ 



dv-mks array will be 
modified needed 3*(""tcv* 
dv"»y\ks avc deleted- 



Delegate 


TV>c edvt WtU …， 

W ⑽ 一 to 
如 edvt— 州 0 dc . 




TV\c delete Will V^dlc 
>,W»^ mode table »s 
* m and ^dlc dclctm^ 
dvmks. 
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saving, editing, and sorting data 


EDITING VIEW CONSTRUCTION 


Using the view below, write what each part of the editing view does. 



Drinh Mixer 


e 


Letnon 


drop 


Firecracker 
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editing view construction 


EDITING VIEW CONSTRUCTION SOLUTION 

Using the view below, write what each part of the editing view does. 


The Vov\t bu*t*bo^ *tu\rhS 
o^f editm^ mode 
puis {ht -table badk bo 
no\nr^al. 


The delete \Coy\s Irt -the 
user ddrle d vow -fvom 
*tKc table. 



pm 


urmk Mixer 


e Lemon drop 


e Firecracker 



The + bu*t*bo^ is 
uhdhar\gcd ： i*t lets us add 
d hew dbrmk. 


W\\cy\ ^ 

•m cdi*t mode, we should 
be able *to edi*b 3 dv-'mk 


ms*tcad jus*t displaym^ 


it- 
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saving, editing, and sorting data 



The Xcode template comes with a good bit of the code well need, and at this point you’re 
pretty familiar with the RootViewController and the table view. Well give you some hints 
on what to implement next, but let you take it from here. 



Add the edit button to the root view. 

We need an edit button in the upper left of the navigation bar. The templated code 
for the UITableViewGontroller comes with everything we need built-in; it’s just a 
matter of uncommenting the line in viewDidLoad. 



Implement the tableView ： commitEditingStyle ： forRowAtIndexPath. 

Once the table view is in editing mode, we’ll get a call when the user tries to delete 
a row either by swiping across the row or tapping the delete indicator. Most of 
this method is stubbed out for us too, but you’ll need to add code to update the 
datasource with the change. Remember, we’ve been mapping rows to indexes in our 
array. Lastly, you don’t need to call reloadData after this change because we ask the 
table View to explicitly remove the row. 


o Update the didSelectRowAtlndexPath to add a drink. 

Our AddDrinkViewGontroller has nearly everything we need to be able 
to edit an existing drink. Update didSelectRowAtlndexPath to invoke the 
AddDrinkViewG ontroller instead of the DrinkDetailViewG ontroller if we’re in 
editing mode. 



Make sure Interface Builder knows its editable. 

Check that “Allow Selection While Editing” is checked for the Drinks table view. 



Add the ability to edit a drink in our AddDrinkViewController. 

You’ll need to tell the app that it must edit a drink instead of creating a new one, then 
have it populate the controls with the existing information, and finally update the 
drink on save. 
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exercise solution 


^ EjcgRciSe 
%oLvt\o 


The Xcode template comes with a good bit of the code 
well need, and at this point you’re pretty familiar with the 
RootViewController and the table view. We’ll give you some 
hints on what to implement next, but let you take it from here. 


o 


Add the edit button to the root view. 

We need an edit button in the upper left of the navigation bar. The templated 
code for the UITableViewGontroller comes with everything we need built-in; 
it’s just a matter of uncommenting the line in viewDidLoad. 

I 灼 vicv/DidLoad 


// Uncomment the following line to display an Edit button in the navigation bar 
for this view controller. 



self.navigationltem.1eftBarButtonItem 

TV>c U|lablc\/ic>wCov>*tv*ollcv- domes v/'rth 
bull 七 - m suffoirt -fov 3y\ cd*i*t AH 

yjc *fco do is add rt *to mv bav. 


RootViewController.m 



Implement the tableView ： commitEditingStyle ： forRowAtIndexPath. 

Once the table view is in editing mode, we’ll get a call when the user tries to delete a row either by 
swiping across the row or tapping the delete indicator. Most of this method is stubbed out for us 
too, but you’ll need to add code to update the datasource with the change. Remember, we’ve been 
mapping rows to indexes in our array. Lastly, you don’t need to call reloadData after this change 
because we ask the table View to explicitly remove the row. 


// Override to support editing the table view. 

- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEdit 



ingStyle)editingStyle forRowAtlndexPath:(NSIndexPath *)indexPath 


if (editingStyle == UITableViewCellEditingStyleDelete) 
// Delete the row from the data source. 




Use vcmovcObjcd*tA*tl^dc% b> 

up ouv d^'tssouvde- 

[self.drinks removeObjectAtlndex : indexPath.row]; … ' 

[tableView deleteRowsAtlndexPaths: [NSArray arrayWithObj ect : indexPath] 
withRowAnimation : UITableViewRowAnimationFade]; 



RootViewController.m 
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❺ Update the didSelectRowAtlndexPath to add a drink. 

Our AddDrinkViewGontroller has nearly everything we need to be able 
to edit an existing drink. Update didSelectRowAtlndexPath to invoke the 
AddDrinkVie wG ontroller instead of the DrinkDetailViewG ontroller if we’re in 
editing mode. 


// Override to support row selection in the table view. 

- (void)tableView:(UITableView *)tableView didSelectRowAtlndexPath:(NSIndexPath *) 
indexPath { 

if (!self.editing) { 

DrinkDetailViewController *drinkDetailViewController = 

[[DrinkDetailViewController alloc] initWithNibName:@’’DrinkDetailViewController” 
bundle : nil]; 

drinkDetailViewController.drink = [self.drinks objectAtlndex:indexPath.row]; 

[self.navigationController pushViewController : drinkDetailViewController 
animated:YES]; 

[drinkDetailViewController release]; 

} 

else { 

AddDrinkViewController *editingDrinkVC 
alloc] initWithNibName : @’’DrinkDetailViewController” bundle : nil]; 

UINavigationController *editingNavCon = [[UINavigationController alloc] 
initWithRootViewController : editingDrinkVC]; 

editingDrinkVC.drink = [self.drinks objectAtlndex : indexPath.row]; 

editingDrinkVC.drinkArray = self.drinks; 

[self.navigationController presentModalViewController : editingNavCon 
animated: YES] ; ^y/e are m mode, Ortait ^ 

[editingDrinkVC release] ; /\adPr*mk\/icv/Co^ollc\r a^d sc*t dhrmk *to 

tA\i addition *to ouv dhrmk a^ay. WII A% 
uf 七 he AddP^i> r 'k\/icwCoh*bv"ollcv , d … 


f wsi y/c bo thedk *fco see i-f v/cVc 

•m mode- l-f jus*t display 

ir>oV*mal dc*t3il ViC>w- 

=[[AddDrinkViewController 


[editingNavCon release] 


o Make sure Interface 
Builder knows its 
editable. 

Check that “Allow Selection 
While Editing” is checked 
for the Drinks table view. 



RootViewController.m 

Just tke 
ActctDrink 
ViewController 
left •“ 
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ExenciSe 


The Xcode template comes with a good bit of the code well need, and at this point you’re pretty 
familiar with the RootViewController and the table view. We’ll give you some hints on what to 
implement next, but let you take it from here. 



Add the ability to edit a drink in our AddDrinkViewController. 

You’ll need to tell it that it must edit a drink instead of creating a new one, then have it 
populate the controls with the existing information, and finally update the drink on save. 


- (void)viewWillAppear : (BOOL)animated { 

[super viewWillAppear:animated]; 

NSLog (『Registering for keyboard events ’’）； 

[[NSNotificationCenter defaultCenter] addObserver : self 
selector : Qselector(keyboardWillShow:) 

name:UIKeyboardWillShowNotification object:self.view.window]; 

[[NSNotificationCenter defaultCenter] addObserver : self 
selector : @selector(keyboardWillHide : ) 
name:UIKeyboardDidHideNotification obj ect : nil]; 

// Initially the keyboard is hidden, so reset our variable 
keyboardVisible = NO; 

if (self.drink != nil) { 

nameTextField.text = [self.drink objectForKey : NAME_KEY]; 
ingredientsTextView.text = [self.drink objectForKey : INGREDIENTS 


KEY]; 
KEY]; 


directionsTextView.text = [self.drink objectForKey : DIRECTIONS 


v/c Kavc a a^mk set, tKat 

supposed to cd-.t ⑽ a f 

a cmdlUecd 仫 foliate ouv Mds 

七 dv-'mk 
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- ( 工 BAction) save : (id) sender . 

NSLog(@"Save pressed!"); 


|-f -tKcvc^s a dvmk se 七 , *to ufda*tc *i*t- Wlc t^r\ 
c*i*tV>cv- update *tV>c objcd*t ov vcflatc it Smdc v/c 

*bo vesov 七七 he >wiiolc 3vv*3y 3y>yv/3y C\y\ dasc "tW dvihk 
y>ame jus*t old one av>d v-c-3dd it 


if (drink != nil) { 

// We A re working with an existing drink, so let's remove 
//it from the array to get ready for a new one 
[drinkArray removeObject:drink]; 

self.drink = nil; // This will release our reference too 



// Now create a new drink dictionary for the new values 
NSMutableDictionary* newDrink = [[NSMutableDictionary alloc] init]; 
[newDrink setValue : nameTextField.text forKey:NAME—KEY]; 

[newDrink setValue : ingredientsTextView.text forKey : 工 NGREDIENTS—KEY]; 
[newDrink setValue : directionsTextView.text forKey:DIRECTIONS KEY]; 

// 涵 lt 心 ―… k _ 

[drinkArray addObject:newDrink]; 

[newDrink release]; 

// Then sort it since the name might have changed with an existing 
// drink or Lt f s a completely new one. 

NSSortDescriptor *nameSorter = [[NSSortDescriptor alloc] initWithKey : NAME_KEY 
ascending : YES selector : @selector(caseInsensitiveCompare:)]; 

[drinkArray sortUsingDescriptors : [NSArray arrayWithObject:nameSorter]]; 

[nameSorter release]; 

// Then pop the detailed view 

[self.navigationController dismissModalViewControllerAnimated : YES]; 



AddDrinkViewController.m 
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ifs all in there 



TesT DriVq 


Make the editing changes to your app and give it a shot. You should be able to 
remove drinks and fine-tune them all you want. Remember to restart your app 
by tapping on the icon, though; otherwise, you’ll lose your changes. 
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After Dinner Mint 
e Aftershock 
O Apple Martini 
O Baked Appfo 

e Bqq GUnger 
Beetle Juke 
O B^ck Eyed Suaan 
Blue Dog 

e Book maker's Luck 



Resutmit your app 
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iTu^ei 


Here’s DrinkMixer at ^l! 
Congratulations! 
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naviga tioncon trollercross 



NavigationControllercross 

Let’s check your scroll view, nav control, and table 
view buzz words! 



Across 

1. A field that the user can change is_ 

2. Arrays load and save using_. 

5. System-level events that can be passed are called 


6. Sort data using the_. 

7. All the sytem events go through the_ 

center. 

8. The scroll view won't work without setting the 


9. viewWillAppear and_are called at different 

times. 


Down 

1. Table views have built-in support for_. 

3. Keyboard events tell you about the_and size of 

the keyboard. 

4. The_handles the scroll bar, panning, 

zooming, and what content is displayed in the view. 
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saving, editing, and sorting data 


I like the automatic editing support 
in the table view, but how do I do those 
cool “Add New Address” rows that the 
iPhone has when you edit a contact? 

It's a lot easier than you think. 

Basically, when you’re in editing mode you 
tell the table view you have one more row 
than you actually have in your data. Then, in 
cellForRowAtlndexPath, check to see if the 
row the table view is asking for is one past 
the end. If it is, return a cell that says “Add 
New Address” or whatever. Finally, in your 
didSelectRowAtlndexPath, check to see if 
the selected row is one past your data, and if 
so, you know it was the selected row. 

We haven’t talked about moving 
rows around, but I’ve seen tables do that. 
Is it hard? 

No, the table view part is really easy; 
it’s the datasource part that can be tricky. If 
you support moving rows around, simply 
implement the method tableview:move 
RowAtlndexPath:tolndexPath (the tableview 
checks to see if you provide this method 
before allowing the user to rearrange 
cells). The users will see a row handle on 
the side of the cells when they’re in editing 
mode. When they move a row, you’ll get 
a call to your new method that provides 
the IndexPath the row started at and the 
IndexPath for the new position. It's your job 
to update your datasource to make sure 
they stay that way. You can also implement 


tJiereiare no ^ 

Dumb Questi9ns 


tableview:canMoveRowAtlndexPath to 
only allow the users to move certain rows. 
There are even finer-grained controls in 
the delegate if you’re interested, such as 
preventing the users from moving a cell to a 
certain section. 

What if I don’t want the users to be 
able to delete a row? Can I still support 
editing for some of the rows? 

Absolutely. Just implement tableview: 
canEditRowAtlndexPath: and return NO for 
the rows you don’t want to be editable. 

When we edit a drink, we replace 
the object in the array. What if we had 
some other view that had a reference to 
the original? 

Great question. The short answer is 
you’re going to have a problem, no matter 
how you handle it. If some other view has a 
reference to the object we removed, that’s 
not tragic since the retain count should 
still be at least 1; the object won’t get 
dealloced when we remove it. However, the 
other views obviously won’t see any of the 
changes the user made since we’re putting 
them in a new dictionary. Even if they had 
the old dictionary, they wouldn't have any 
way of knowing the values changed. There 
are a few ways you could handle this. One 
option is you could change our code to leave 
the original object in the array and modify it 
in place, then make sure that any other view 
you have refreshes itself on viewWillAppear 


or something along those lines. Another 
option is you could send out a custom 
notification that the drink array changed 
or that a particular drink was modified. 
Interested views can register to receive that 
notification. 

Aren’t we supposed to be 
concerned about efficiency? Isn’t 
removing the drink and reading it 
inefficient? 

It’s not the most efficient way since 
it requires finding the object in the array 
and removing it before reinserting it, but for 
the sake of code clarity we decided it was 
simpler to show. We’d have to re-sort the 
array regardless of which approach we took, 
however, since the name of the drink (and 
its place alphabetically) could change with 
the edit. 

We added the edit button on the 
left-hand side of the detail view, but what 
about a back button? Isn’t that where 
they usually go? 

That's true. When you get into having 
an add button, an edit button, and a back 
button, you run into a real estate problem. 
The way we solved it was fine, but you’ll 
need to make sure that your app flows the 
way you need it to when your navigation 
controller starts to get crowded. 
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navigationcon trollercross solution 



NavigationControllercposs 

Solution 


Let’s check your scroll view, nav control, and table view 
buzz words! 



Across 

1. A field that the user can change is_. 

[EDITABLE] 

2. Arrays load and save using_■ [NSCODING] 

5. System-level events that can be passed are called 
_. [NOTIFICATIONS] 

6. Sort data using the_. 

[NSSORTDESCRIPTOR] 

7. All the sytem events go through the_ 

center. [DEFAULT] 

8. The scroll view won't work without setting the 
_■ [CONTENTSIZE] 

9. viewWillAppear and_are called at different 

times. [VIEWDIDLOAD] 


Down 

1. Table views have built-in support for_. 

[EDITING] 

3. Keyboard events tell you about the_and size of 

the keyboard. [STATE] 

4. The_handles the scroll bar, panning, 

zooming, and what content is displayed in the view. 
[SCROLLVIEW] 
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saving, editing, and sorting data 


Your iPhowc Pevelopment Toolbox 

You’ve got Chapter 6 under your belt 
and now you’ve added saving, editing, 
and sorting data to your toolbox. For a 
complete list of tooltips in the book, go to 
http://www.headfirstlabs.com/iphonedev. 



Scroll \/icw 

like d IchS -fco show ohly *thc 
part the view you heed av\d 
scrolls 七 he \rcs*t o^f -the sdv-cch. 

Meeds *to be jivch 3 doh*tch*tSizjC 
*to work p\ropc\rly. 

Cah be easily dohS-trud-tcd ih 
|h*tc\r-fadc Builder 
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/\ rc system-level events you 
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The default eerier 
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7 tab bars and core data 

% Ehicv-pvisc 

Bounty hmter s^pps ^ 



Enterprise apps mean managing more data in different ways. 

Companies large and small are a significant market for iPhone apps. A small handheld 
device with a custom app can be huge for companies that have staff on the go. Most 
of these apps are going to manage lots of data, and iPhone 3.x has built in Core Data 
support. Working with that and another new controller, the tab bar controller, we’re going 
to build an app for justice! 


this is a new chapter 
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bob^ on the go 


HF bounty hunting 



o 


Bob ihe bouh-ty 


huhtcv - 


o 


With my business, I'm out of the office a lot. 
I got a new iPhone to take with me, and now I 
need an app help me keep track of fugitives. 


Bob needs some help. 

Bounty hunting is not a desk job; Bob needs lots 
of information to pick up fugitives. His iPhone 
is ideal to take along on the job and bring all of 
his case files with him. Here’s what Bob needs in 
his app: 


Bob needs a list of fugitives. He has to keep 
track of everyone he’s looking for, along with 
people he’s captured. 


❺ He wants to be able to quickly display a list of 
just the captured fugitives. 



He also needs a display of the detailed 
information about each fugitive, like what 
they’re wanted for, where they were last seen, 
and how much their bounty is. 
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tab bars and core data 


r^Sbarp your pencil 


Time for some design work. You have Bob’s 
requirements — take them and sketch up what 
you think we’ll need for this app. 
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tab bars easily access multiple views 



We’re going to need three views. Using Bob’s 
parameters, here’s what we came up with. 




tab bav- 6o\rrbrolle\r，user 
dart c\\c\c on -tab a*t botW 
street -to beWa views. 


o Bob needs a list of fugitives. He keeps 
track of everyone he’s looking for or 
has captured. 


❺ Joe wants to be able to quickly display a 
list of just the captured fugitives/ 


lA/c’ll keep -bv-atk 
%,t»vc dala sorbed W 


The «\uidkcsi v/ay b> sv/i-Uh bciwcc»J 
di*WWerrt lists is wiih a tab bav 
do^iv-ollcv-. 


Fo\r cadh list, 
well use a 
*t«>blc view, like 
we did with 
Dv-ihkA1ixcv-. 
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tab bars and core data 


r y ou 「 P e 吣 I 

\ Solution 


O Bob wants a display of the 

detailed information about each 
fugitive. 


TV>c detail vb 心 r 
cat\\ -furtive Will be 
available >07 c\\cM\^ 

dviy 扒 awe. 



For dd*td y/eVe 

^o*m^ *bo use hew iPhone 

-tcdKholo^y, Core Data. I*t 乙如 

a lo*t o-f di-f-fcrch*t ddia 
types -for your app. 



TV\'»s a 代 a ’ 丨“饮 

y\o 七 es a 灼 d ddiU 
abou*t *b^c -fuy*bWc 


"The -bb bar 

^hro\W will s-till 

tc visible. 



Td^ Bar Up Cl^se 


The tab bar controller is another common iPhone 
interface. Unlike the navigation controller, there 
isn’t really a stack. All of the views are created up 
front and easily accessed by clicking the tab, with 
each tab being tied to a specific view. 

Tab bars are better suited to tasks or data that 
are related, but not necessarily hierarchical. The 
UITabBarController keeps track of all of the views 
and swaps between them based on user input. 

Standard iPhone apps that have tab bar controllers 
include the phone app, and the iPod. 



丁 ^ bbs 
^Cn,sclvc 
icxi 


饮 鈿 i 




















u. 


■PncrM 3 


4^ fla wljifl 
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The tab 
ba\r 63y\ 
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3 hy view 
you heed. 
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which template? 


Choose a template to start iPouwtyHuwtcr 

This time around, we have a lot going on in our app. A navigation controller, 
a tab bar, and Core Data, too. Gore Data is an optional add-on to many of 
the templates, including the basic window-based app. We’re going to start 
with the window-based app and add the tab bar and the navigation controller 
with interface builder and a little bit of code. 



Pitk v/’mdov /— 
basedi 

七 Wis time avou^d 


suire -the 

to}rc dsia box is 

亡 he 匕 ked. 


Chooir a 惊 mpl ■代 your tww project 






fjjt 


FrlmtMfV £ Ubw 
^-il^rn Plug -in 





DjitnCL FS 

iipplkmlMW 


參 



AkUcje^ 


$pik-ni *〆 ywCw 1 职嗶 


■iir 




"-v vi'lndaw-bi^rd ftpplicalinn 


TT .s resell 仲 
Data, n praw 

jnd «Ua.yUh^ p^rflllpnl s3 



Wait, I thought we were using 
a tab bar controller. Theres a 
template for it right there—why 
aren’t we using that one? 



iBountyHunter is a bit more complicated than 
just one template. 

If you look back at the views you sketched, we’re also going to 
have some navigation controller capabilities and table views. We’d 
have to do quite a bit of extra work to get those working in the 
tab bar template. With all of that going on, it’s easier to start from 
a windows-based app (a basic template) and add to it, rather than 
working with a template that doesn’t quite fit our needs. 
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tab bars and core data 



Jim: OK, what do we do now? All we have is an empty view. 

Joe: Well, we need to add two table views, the tab bar navigation 
controller to switch between those views, and the detail view. 

Frank: So do we need a bunch of new nib files to handle all 
these views and controls? 

Jim: Ugh. This basic template gave us nothing! 

Joe: It’s not so bad. I like to think of it as a blank slate. Let’s see, 
we can start with the tab bar and tab bar controller... 

Frank: Right, that will switch between the two table views 
for Fugitive and Captured. Those views will each need nav 
controllers as well, to get in and out of the detailed view. 

Joe ： So do we need separate nibs for the tab bar and those two 
views? It seems like maybe we could have all those controls in just 
one nib, for the tab bar and the two views, since they’re basically 
the same. 

Jim: Yeah, but we’d still need view controllers, headers, and .m 
files for each of those views. 

Joe: Yup, they’re the views that need the tables in them. We’d 
also need a detail view with it’s own nib and view controller, with 
the .h and .m files, right? 

Frank: That sounds about right. We can use Interface Builder to 
create the tab bar and navigation controllers. 

Joe: What do we do about the rest of the stuff? Add new files in 
Xcode? 

Frank: That’ll work — like before, we just need to specify that the 
nib files are created at the same time, and we should be good to 
go. 

Jim: I think that all makes sense — it’s a lot to keep track of. 

Joe: Well, we’re combining like three different things now, so it’s 
definitely going to get more complicated! Maybe it would help to 
diagram how this will all fit together? 
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iBountyHunter bird’s-eye view 


Prawiwg how iPouwtyHuwtcr works- 


\ y \ *tWis tasc, 
it’ll be a 
S6^L'i*tc 
database. 






Core data 
fugitive 
data 
source 


# 



iBountyHunter 

AppDelegate 
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ViewController 
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ViewController 
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tab bars and core data 



Joe: That helps a lot. So we only need two nibs, one to handle 
the controls for the tab bar switching between Fugitive and 
Captured views, and another to handle the detail view. 

Frank: I get it. We need to put the table view components 
somewhere, and we can either create new nibs for each view and 
have the tab controller load them... 

Jim: ...or we can just include it all in one nib. Easy! 

Frank: Exactly. Since we don’t plan to reuse those table views 
anywhere else and they’re not too complicated, we can keep 
everything a bit simpler with just one nib. 

Jim: And we need view controllers for the two table views, 
along with the detail view. They’ll handle gettting the right data, 
depending on which view the user is in. 

Frank: Plus a navigation controller for the table views to 
transition to and from the detail view. 

Joe: I think we’re ready to start building! 


P 。以 


|. Crtait ^ ^ 

趴 d Ca?W, a ar^di a 


Rollers (V )。仏 


•V> aW w 
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no dumb questions 


Why are we using a tab bar 
controller and bl table view? 

Our Fugitive data is hierarchical and 
lends itself well to a table view. The problem 
is, we have two table views: the fugitive list 
and the captured list. To support two top- 
level lists, we chose a tab bar. 

Couldn’t you have done something 
similar with a toggle switch, like a 
UlSegmentControl? 

Yes, we could have. It’s really a Ul 
design choice. The two lists are really 
different lists, not just different ways of 
sorting or organizing the same data. It's 
subjective, though. 



Dumb Questi9ns 

OK, I'm still a bit confused about 
the business with using just one nib for 
the tab controller and the two table views. 

Well, there is a lot going on in this app, 
and we could have done this a different way. 
We could create two more nibs, each with 
a nav controller and a table view in it. Then 
we’d tell the tab bar controller to load the 
first one as the Fugitive List and the second 
one as the Captured List. Rather than do 
that, we just put all those controls for the list 
in the same nib as the tab bar. Remember, 
the nib is just the Ul controls, not the 
behavior. 

Seriously, though—this is a better 
approach than just using the Tab Bar 
template and adjusting it based on what 
we need? 


That is definitely an option. However, 
if we look at using the TabBar template, it 
comes with two branches, with one broken 
out into a nib to show that you can do it and 
the other right in the same nib (to show you 
could do that too). So we’d have to change 
one, or continue splitting the a 叩 roach, 
which can get ugly pretty quick. We’d 
also have to change a ton of the default 
configurations, half of which are in another 
nib, and half of which are embedded. In the 
end, this approach was less complicated and 
built on the methods you've already learned 
thus far. 




Da this! 




Add an icon for your app. 

You’re about to whip up a lot of code. Before you dive in, go to 
http:/ / www.headfirstlabs.com/iphonedev and download the 
iBountyHunter icon (ibountyicon.png) and drop it in your new 
project in the /Resources folder. Then open up iBountyHunter- 
info.plist in Xcode and type the name of the file in the icon entry. 



-files Y\ttd 

to be ^*7 ^ ^ 

pixels. 
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tab bars and core data 



EiteRciSe 


Create your two new classes for the Fugitive and Captured 
views in Xcode, and then add your tab bar controller in 
Interface Builder. 



Create two new classes with .m # and .h. files. 

These will be the view controllers for the Fugitive List 
and the Captured List. FugitiveListViewGontroller.h 
and .m and GapturedListViewGontroller.h and .m both 
need to be subclasses of UITableViewGontroller, so select 
“UlViewController subclass” and check UITableViewGontroller 
subclass. 



Add the tab bar controller. 

In Interface Builder, open the MainWindow.xib to get started, 
and drop the tab bar controller in the view. 
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exercise solution 




BcesciSe 


Create your two new classes for the Fugitive and Captured 
view controllers in Xcode, and then add your tab bar controller 
in Interface Builder. 


◦ Create two new classes, each 
with .m # and .h files. 

l/VWh you crcaic these, make su^c 
that *thcy 3\rc UlTablcl/icy/Cohtv-ollcV" 
subclasses, a^d that Ik ( With XlB ^ 
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tteves what youv- -Pile 
listing should look like 
youVc dohe. 




You don’t get the UlTableViewController 
checkbox in Xcode 3.1! 

If you’re not using XCode 3.2 (Snow Leopard), you’ll need 
to go into both your CapturedListViewController. h and 
FugitiveListViewController.h files and change them from 
UlViewController to UlTableViewController subclasses. 
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tab bars and core data 


❺ 


Add the tab bar controller. 

The window template doesn’t give us a whole 
lot out of the box. We’re going to use Interface 
Builder to assemble our views and view 
controllers the way we want them. 




The *tcmpla*tc Comes By\ cmp*ty 

UllVi^dov/. I Vs -the window ouv- app 
delegate will display i*t s*ta\rb. 
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Drag the tab bar controller from the Library into your 
main window listing. This will create your Tab Controller 
view: 
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building the fugitive view 


Puild the fugitive list view 


We’re going to focus on the Fugitive List first, but the same steps will apply to 
the Captured List when we get to it. 



Delete those two view controllers and 
replace them with navigation controllers. 

Since we want all of the functionality that comes with 
a nav controller, delete those the view controllers and 
drag two new nav controllers in their place from the 
Library. Make sure they’re listed underneath the tab 
bar controller. 
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Change the view controller to the 
FugitiveListView controller. 

Highlight the view controller under the first navigation 
controller and use §€4 to change the Class to 
Fugitive ListViewGontroller. 
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tab bars and core data 



Add the table view. 


Now that you’ve changed your first navigation controller to use 
the FugitiveListViewGontroller, it needs a view. Drag a table view 
from the Library over as a child for that view controller. 
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m T«ih 3.ir lh % fn !r“[jiihvni 


DMgiila^i i sini9l4> caluim lli[ >iF AHiluple 

dmn. IhrtmqJi HThE h ULPriL 

mmmA iIia Is i yrfjbreVl^irCtll 
南 qL The ^<fl ifp-lf E^lll V¥CW 

•IYIwE Ifufl IfUK full Wlrin Cll 3 FJbfl all^W 

and iMr* diipliY opc»fu] Ir^ad^ii jnd 
liKrirn for JilididiY v^Eicm eitmii jiuJ 
Icsr rtiv- r.MNi a l j e ghtwpl# Tlw qraypihd -ir^ifl 


fl- a" 



Set the names in the tabbar and navbar. 

To change the title for the Fugitive List view controller, double-click 
on the title in the nav bar and type “Fugitives”. For the tab, click on 
the first item, §€l, change the Bar Item Title to “Fugitives”. 


H ^ ^ 

MamWmdDw.xib 

n?. 


V%w 

IllipeLlOl SciTLh FllfUS 

Nnmf 



_ l Ab br LfmErgller 
"Tjibi tjr 

Hi rfimirrallfiP (Tugiiivn] 

^ harvlgaliqn Bar 

▼ O FUgiElve LliSiE View Cdfisrollci LTygiivts^ 
TaElIf Vi#w 

NjMlgalion I Lem {FugiLivci) 


(Tugmves} 



LID aliBarLontr^IlN 
UFTaliftjr 

Ul^avigatpwihr 

FbfliTivcUsiVlt^DPTfalfer 

UETilMifVi^w 

LI IN 加 g dliWI ll??n 


n 


w 



C' IB&jnfvNyfiEsr.x.c^d 




Updated ^av 

^Oh-t\rollc\r title 


IS 匕 harmed with 

the bad^e item. 


Clitk V>cvc *to 七 he 

v*ie>w tor>*tv-ollcv- 



Cup^fllrlQ 

Okndvle 


Udk Arig*l*» 
Palp AJlq' 

San 


FlflrAHEiaCe 
Santa Cl#r> 



Vtcw t»tlc 


Wltat’s next? 
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checking things off your list 


Next up: the captured view 

You’ve just gone through and created the classes for your two table views, and 
dropped in a tab controller to switch between the two. 


Jus*t do 七 he same 
wc did cav-|ic\r 
wi*th 七 he Fugitives view. 


Rcmcmbcv -fvom 
dov>vcv-sa*tior> cav-l'icv-? 





alor\^ …办 


a 


“ 咖岍 ^ au ; 




arv 


、d 




\l\t^ 


Ii3vch "t dov\c this 

yd T"Koi*t s "to 

some dode dhd |B 
wo\rk; well tovtxt \>adc -to 
•t m a mihutc. 
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tab bars and core data 


BE th^ Dev 初改 

Your job is to he developer and finish up tire 
orl^ in Xcode and Interface Builder to get tiie 
Fugitive and Captured views worfeig wiSitiie 

tab bar controller. Use tire to-do 
list from Jim, Frarik, and Joe to 
figure outA^iafs left. 



It’s up to you to create tke 
captured view，anct tken connect 
tke views up witk tke tat tar 
controller... 
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be the solution 



BE th^ §©luffen 

Your job is to he tire developer and finish up 
tiie wort in Xcode and Interface Builder to 
贫 et tire Fugitive and C^tured views worl^in^. 


Then wire up the tab bar controller. 


Create your captured view. 

Follow the same steps from earlier for 
creating the Fugitive view. 


V^m bUmlm 


MjInWindbwJiib 


Lmpitlilr 


irwith r_y 


Hi 


_ ^JMHiaibon L>£m^r[Hl£ ； r>IFLig>Ci^C£l 

知 huvSBiCMSfi br 

"I fif^rlivx' LL-ht Viri¥ Conlrpllfr ffugrlr 
t4lale Vito 

■ h^viD^tiOn ICtm If Lf9_1i 被 Eli 

B Tlss Bilf him iFuqir^J 


Tn* 

UIMVi_AJban£ ； ci^lrtHkr 

UINftVfQJ^iDPBJT 
Fug IE m 1 Li p>|Vi rwC Ean l r 
UlTiHcVlTW 
IJlitarpigjCictnrCtm 
urTahHjFh 式 m 


hjLviD^tr«n hr 

LI CacKyrc?d |iH V'fcvh Concncilkrr ^Ca^TD^cd) 
TiUt 

■ i^viyjl^n lE-Fm (l^jpCijrpH|i 

|H TiA lir RinAi _ 


rfdU icVl^iCwi uol Ic r 

UmjHigjfciimltFm 

iJIlabfljrninA 


You should cr>d uf v/ith a 
lis 七七 ha 七 loob like 七 Wis. 


To do this, we need to go back to the AppDelegate. 
Right now, there isn’t an outlet to connect the tab bar 
controller to anything, so it won’t work. You should be 
pretty familiar with how to do this by now. Here’s the 
outlet you need for a tab controller: 



iBountyHunterAppDelegate.h 


Almost tliere •“ 
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tab bars and core data 




Hcvc WII Y\ttd bo Wwt up 七 he 



Delegate *fco *tKc "lab Bav- 
Co^*tvollcv*. ) 


« ^ ^ 




v 洲 E 


i lli'ji 


Cl ^ 

ImpM 如 




lr|4 hcLEH^der 


UiRticwnd 4 f 


WdlnWiTKkswjiib 


Tfftw 




Wr^lBsy 

t yi fill br 

誦 1 §M taf 

響 hjYiydlinn f>nfi9mllrr {FugiElvnj 
^ hJiftfalwi Oar 

T U f Lifl» 1 lvE UiC VhC# Co^Tra-^r ( 
麵 KjuigjilcB^vi IfcFm {Tug 1r«^PL| 

U f-ftb hr Hurw^ IF-ygitiMSI 


tarcfirKfnf UulMi 
il|ltaiati ^ 


lut 沾 Baium 


tKereiare no o 

Dumb Questi9ns 


We have a lot jammed in our main 
window nib. It still seems kinda strange 
to me. 

The nib for iBountyHunter contains five 
controllers (the tab bar, two nav controllers, 
and our FugitiveListViewController and 
CapturedListViewController) and their 
associated components. If you're still 
having trouble with the idea, it might help 
to open the MainWindow.xib file in Interface 
Builder and view it in tree mode. Expanding 
the hierarchy shows the structure of our 
app. We have a single nib with a tab bar 
controller, which internally has two nav 
controllers nested underneath it that are 
instances of FugitiveListViewController and 
CapturedListViewController, respectively. 

Can I add icons to the tab bar tabs? 


Absolutely. The easiest way is to pick 
a standard icon using Interface Builder. To 
do that, click on the question mark icon on 
the tab you want to change, then change 
the Identifier in the Inspector. If you want 
to use a custom image, set the Identifier to 
custom, then select your image in the Image 
field (you’ll need to add it to your project, just 
like we did with the application icon earlier). 
There are a couple of peculiarities with Tab 
Bar icons, though: they should be 30x30 
and the alpha values in the icon are used to 
actually create the image. You can’t specify 
colors or anything like that. 

How many views can I have in a 
tabbar? 

As many as you want. If you add 
more views than can fit across the tab bar 
at the bottom, the UlTabBarController will 
automatically add a “More” item and show 


the rest in a table view. By default, the 
UlTabBarController also includes an Edit 
button that lets the user edit which tabs are 
on the bottom bar. 

Is there anyway of knowing when a 
user switches tabs? 

Yes, there’s a UlTabBarDelegate 
protocol you can conform to and set as the 
tab bar delegate. You'll be notified when the 
users are customizing the bottom bar and 
when they change tabs. 

Why did we add a reference to the 
tab bar controller in the App Delegate? 

We've added the tab bar controller to 
the nib, but there's a little more tweaking 
we’re going to have to do to get everything 
displaying properly. Go ahead and give it a 
Test Drive to see what’s going on... 
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test drive 



Tesr DriVq 


You’ve just done a lot of work on your app—new view controllers, new nav controllers, table 
views—all from scratch. Build and run to make sure that everything’s working. 



Ugflt! Votkingf! Wky isn^t tke tat tar 
controller (or anytking else) teing[ ctisplayect? 
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tab bars and core data 


Sharp your pencil 


Figure out what’s going on. Look at what we 
did earlier in Interface Builder and see if you 
can figure out where we went wrong... 



you are here ► 


323 

















































ill components are subviews 


«^harp€n your pencil 

Solution 




Figure out what’s going on. Look at what we 
did earlier in Interface Builder and see if you 
can figure out where we went wrong... 


The problem is 
tab bd\r is d -fcop-lcvd 
elemeirrt m -the nib. The 
AppDcIcjatc has the 

Ul^/i^dow as i*ts y/'mdoy/, 
so delegate will 

display wmdov/. Bu 七 

UllVi^dow do ⑽’七 

dohtim it hds 

y\o subviews. 

Wc y\ttA *bo erwbed -the 

tab ba\r 6ojrrbrollc\r *m*bo 
■the UliVi^idiow. 



A view's contents arc actually subviews 

All of the UI components we’ve used are subclasses of UlView. By 
dropping them into a view we’ve made them subviews of some bigger, 
container view. We need to do the same thing with our tab bar; however, 
the problem is that we can’t get to the UlWindow’s view in Interface 
Builder. We’ll need to do this in code. 


㈣ t: 

3lso ^ do^ ih Cod ^ 




- (void)applicationDidFinishLaunching:(UIApplication *)application { 

// Override point for customization after app launch 

[window addSubview : tabcontroller. view] ; »ed "bo mdke bav- d subv'icv/ 

[window makeKeyAndVisible]; ^ Jc -tKc Ulv^'mdoy/. You C^v\ do m tKc 


[window makeKeyAndVisible]; ^ o\ tKc UlWmdoy/. you cav\ ao 

} 、乂 ApplicationDidFinishLaunchmc 

_ method. I I 



iBountyHunterAppDelegate.m 
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tab bars and core data 



Tesr DriVq 


We’re close. There are a few more connections we need to put 
together in Interface Builder to wrap it up. 

The table views also need to be connected to both view controllers, as 
well as outlets from the App Delegate to both the fugitive controller 
and the captured controller. 


« ^ ^ 


MalnWIndow.idb 
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W l^b BUf LantraFitr 


Jib B^r 


r"i iBiauntytiL-nEif jccsdrcproi 


both tabic views, tk delegate 
datasou\rdcs heed -to be dohhe^ted 
■to thci\r pa\TCht view dohtvolld 


UIWIridCFiv 


UllibBnULDntr'DlrEr 


UlTiibBEif 


Y _ NjiMkgnticin rimnli'Dlifj Ifu^itivnl' 

■ 时 JvrigjNon hr 

« > rygiutvit LJis VltA'ConErallier^FiJHglElves-i 
^""""tiblt Vitw 
/ «i MnviigjEbnn lEr-m ijFNgiTivr 1 !) 

fil Tjb Bjr Item ^rugiiLivci> 

- m Sclfaid NjrMi^i^Dn CancrallcnCjpEyfedi 


讎 




I IIN.ivig'Jlinnr nnUniln 
UINjvig JlipnBjir 
FuqiEivelJfiViewConEroil&r 
UlldbicV^ew 

I llhJ.iv 中 Ei<nnLl pm 
1JirTd.bBaillcm 
UINsvigoi^DnCsmcBiilcr 
UINiivifMliiDnBar 


(J Cdpturnl LUt View CofilrdHtf CCipt. 
7 Tj3]Il- y\rw 


CdpCy rtdbKVit'rtila 
MlT.LblrVirvi 


u NovlqaUDniTCfn 


—.NsvIgjiEl^n Utm ^C^pcur^cfi 
Tib kr tTfm fC^piurcd} 
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tab bar in action 




Tqst DriVQ 


It’s time to see everything working. Build and run and 
you can see both tab views working with tables. 




Rcmcmfecv 七 ^ 七 \COYx Y/C 
•mstallcd cavl'ic^r? aV>cad 
a^d Wi*t \\or^t key -to 


eMtck »*t ou 七 . 
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tab bars and core data 


After a quick meeting with fob". 



Looks great so far. Heres my 
list of fugitives. Right now ifs 
pretty old school—just a typed 
list from the court. 


Managing Bob’s data is 



Now that the app is up and 
running, you need to fill in the 
blanks. The list is pretty simple 
right now, so we can make the 
data into any form we want and 
then import it. 


the next step. 



_ 

How should we represent the data? 
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picking data storage 



Frank: I was thinking — I’m not sure a plist is such a good idea 
this time. 

Jim: Why not? We used it for DrinkMixer, and it worked fine. 

Frank: Well, this list could get pretty big — remember, the list of 
fugitives is going to be ongoing: the ones that Bob is trying to catch 
and those that he already has. 

Joe: So? 

Frank: So... a big list means lots of memory. 

Joe: Oh, that’s right — and the plist loaded the entire thing every 
time. 

Frank: Exactly. 

Jim: What about that Gore Data thing, that’s supposed to handle 
large amounts of data, right? 

Frank: That’s the new 3.x data framework. That would probably 
work. 

Jim: Why use that and not just a database? Doesn’t iPhone have 
SQLite support? 

Frank: It does, but I’m not a SQL expert, and Gore Data can 
support all kinds of data, including SQL, but you don’t have to talk 
to it directly. 

Joe: I thought you said we weren’t using SQLite? 

Frank: We are, but we’ll use Gore Data to access it. 

Joe: How does that work? 

Frank: Gore Data handles all of the dirty work for us, we just 
need to tell it what data we want to load and save... 





What are some other limitations with how we stored 
data in plists and dictionaries with DrinkMixer? 
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tab bars and core data 


Core Pata lets you focus on your app 


Loading and saving data, particularly lots of data, is a major part of most 
applications. We’ve already spent a lot of time working with plists and 
moving objects in and out of arrays. But what if you wanted to sort that 
data in a bunch of different ways, or only see fugitives worth more than 
S 1,000,000, or handle 100,000 fugitives? Writing code to handle that 
kind of persistence gets really old, really quickly. Enter Gore Data... 



Ua,,cd Ehtitics) look like. 


㈣ 



database o\r simple bih 扣 y 


Put wait there's more! 


Gore Data makes loading and saving your data a snap, but it 
doesn’t stop there. It’s a mature framework that Apple brought 
over from Mac OS X to the iPhone in version 3.0 and gives you: 




The ability to load and save your objects 

Core Data automatically loads and saves your objects based 
on Entity descriptions. It can even handle relationships 
between objects, migrating between versions of your data, 
required and optional fields, and field validation. 




Different ways to store your data 

Core Data hides how your data is actually stored from 
your application. You could read and write to a SQLite 
database or a custom binary file by simply telling Core 
Data how you want it to save your stuff. 

Memory management with undo and redo 

Core Data can be extremely efficient about managing 
objects in memory and tracking changes to objects. 

You can use it for undo and redo, paging through huge 
databases of information, and more. 


But before we do any ol 
tkat, we need to tell Core 
Data al>out our objects … 
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core data population 


Core Pata needs to know what to load 


We need Core Data to load and save the fugitive information and we 
need to populate our detailed view. If you think back to DrinkMixer, 
we used dictionaries to hold our drink information and accessed them 
with keys, like this: 


【讀 ％ 


〜七 iv e 
Fugi+ive lt > 养 


nameTextField.text = [drink objectForKey : NAME_KEY]; 
ingredientsTextView.text = [drink objectForKey:INGREDIENTS 一 KEY] 
directionsTextView.text = [drink objectForKey : DIRECTIONS KEY]; 


The problem with dictionaries and plists was that we had to store 
all of our data using basic types and get to this data with dictionary 
keys. We could have easily had a bug if we put the wrong type in the 
Dictionary or used the wrong key and caused lots of problems later. 
What we really want is to use normal Objective-G classes and objects 
where we can declare properties for the fields, use real data types, etc. 
That’s exactly what Gore Data lets us do. 


5 

pvmkM • 说 v wsed 

(Jiv'mk • 丨 wfovwat ，。 卜 I 七 
^ovkcd, wt v/as ^tibl 

yvWrtWc. 



Use Cove 
Vais io 
populate this. 




TV^csc are ^ 
use ^ ^ 

tlass m Objcdtwc -C* 


Fuji-bi 


vc 


NSS"bv*ihj 决灼 aw 

NSDcdimal Numbcv- bounty 

•m 七 -fugitiveIP 


NSS*bv-*m^ ^dese 




0}ri ^icd goodie X 


Cove pata v/ovks Wrbh 

W 必 ad 

-to 5 'wc US {)r\t 00 
从 〜 av ' 七 . 


P»dt»o^av'«cs v/ovked 

^OV pvmkMwv, w 七 
ovidc dl 


do〆 七 ?v*ov«dc avW 
kmd o“7?e sa^et/ 
ov ev^a?sulaW 〆 

ouv data- T>mc w 

sowbWmS betbd.. 


We need to define our types... 

Not only can Gore Data give us the OO-based 
view of our data that we want, it can even define 
our data graphically. There’s one snag though — 
out of the box, Gore Data supports a specific set 
of data types, so we need to define our entity using 
the types it offers... 
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tab bars and core data 





m 


Match each field we need to implement for the data view to it’s Gore 
Data type. 


Field fjje Detail VleW 


Core Dqta Type 


Name 


fiQimty 



Description 


Int32 A ir bit i 士， 


String 

E^uivalcht -fco 
/VSS-tv-ih^ 
attv-ibutc 


Boolean 


A dOOL value 
(v/B ov KO) 


Decimal 


lf iXed ^i 


d ^i^/ 


^Idcv' 


Date 




you are here ► 


331 








whafs your type? 







Match each field we need to implement for the data view to it’s Gore 
Data type. 


Field for the Detail VleW 


Core D 啦 Type 



Int32 



This will be 
v-cpircsch-tcd as av\ 

Ws/Vumbc\r ih Obj-C. 


String 


£<\uivalch-t -to 

/VS£-t\rih0 

^ttv-ibutc 


Boolean 



A 300L value 

(Yt£ ov KO) 


Decimal 
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tab bars and core data 


Core Pata describes entities with a 
Managed Object Model 


Entities controlled by Core Data are called Managed Objects. The 
way you capture your entity descriptions (properties, relationships, 
type information, etc.) for Gore Data is through a Managed Object 
Model. Gore Data looks at that Managed Object Model at runtime 
to figure out how to load and save data from its persistence store 
(e.g., a database). The Xcode template we used comes with an empty 
Managed Object Model to get us started. 


參 1 ， 












TV tcr^pla-tc is sc ^ 

U P So CoYt Vaia 
^11 i^ry io load all of 
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OhC. 






rl l I 
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>«l-nfiAa 


n irhfliai 
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I 




the Fugi^vc ch-ti-ty. 



TcdWdalh/ 7 。“孙 6yrc ^ c 3 , 

make \i mudV^ cas»cv- 


Let’s go akeact anct create our Fugitive entity 


參#參 
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fugitive description 

Puild your Fugitive cwtity 

We need to create a Fugitive entity in our Managed Object 
Model. Since our Fugitive doesn’t have any relationships 
to other classes, we just need to add properties. Open up 
iBountyHunter . xcdatamodel in the Resources group to 
create the Fugitive data type. 


o 


To add the Fugitive entity, click 
the “plus” button here, and 
change the name to “Fugitive”. 


mm 


cdiW lets you 

产 pities -to 0; 

whetheir rt s tit. IVcVc 

hot 9 oih 9 ^ these jus-t yet... 




^lmuU[or' ^.1H Dc-biffl 






IkejJhpalni；! Build htk! P^uri t ■ 
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Froitci: 
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\ ，: D w 


A nrtodel 
is called ah 
w Eht.ty w 


Eadh dais -field is 

扣 u a^Hbu-t c . w 


xVp« , 

PtflrMl 


AfmlhJi* 




o 




c 


Once the entity exists, you can 
add attributes to the data model, 
using a plus button again. 


Uj,m Vmli 




j EhHMlil t 



/ 



|4 

1 




❺ 


fugllm 


V jhUdiirCn 

be^muf 




Use these fields 
to edit the name 
and type of the 
property. You 
should use 
your normal 
property naming 
convention when 
naming these. 


|/ 说 !0:. 




Th,s dia 3 … k auiomatidall' 

3 仏〜 a+ed *to y ou a i 

， a| ircplrcsch^-tioh op -the 


dsiei be 


… 3 ^3hol0cc|. 


I-P y/c Kad mu Itiflc 

entities you^d see *thc 
o*thcvs heve boo, alo% 

七 heiv v-clatior>sK*ips. 
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tab bars and core data 




MANAGED OBJECT MODEL CONSTRUCTION 


Finish building the Fugitive entity in the Managed Object 
Model based on the Fugitive information we want to store. 
Remember, Core Data Types won’t match our Objective-C 
types exactly. Make sure you name your properties the 
same as we have in the Fugitive diagram shown below. 








wed- 




vc 




NSPcdimalNumbcv- bouvrty 
•m 七 -fugitiveIP 

NSS*tv-*mj 来 dest 


r 1 


㈣ yo “ sc 


丁 ㈣ 



^ w 
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construction solution 


MANAGED OBJECT MODEL CONSTRUCTION SOLUTION 


// 


// 


Finish building the Fugitive entity in the Managed Object Model based on the Fugitive 
information we want to store. Remember, Core Data Types won’t match our Objective-C types 
exactly. Make sure you name your properties the same as we used in the Fugitive diagram. 




CV^k you used 
same -types -for you\r 
pv-opcv"*tics as y/c dtd- 
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TVp« ^inng 
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Ek^uhVd 亂 






r AmihyLM 

fiipMlP 

narn€_ 

'ftrUl iiinh j^pia 
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iz 


a ： 




Make su^rc tV^c “oftioW 
bo% is u^etked -fov- all oi 

*tV^ fv-ofcv-tics. 


y o iA\r Furtive tY\hbf should 
-foiAV" p\ropcv"*tics 3y\d 
y\o v-clatioy\sW»ps. 



Make sure your object model matches ours exactly! 

When you're writing your own apps, there are lots of ways 
to set up your data model, but since we’re going to give you 
a database for iBountyHunter, your model must match ours 
exactly! 
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tab bars and core data 


Why did you use an 

NSDecimalNumber for the bounty? Why 
not a float or a double? 

We’re going to store a currency value 
in the bounty field, so we want precision 
with the decimal part of the figure. Floats 
and Doubles are approximations, so you 
tend to get things like $9.999999998 
instead of $10.00 when using them for 
currency calculations. Our choice of 
NSDecimalNumber for the bounty has 
nothing to do with Core Data and everything 
to do with what we're trying to store. 

What are the transient and indexed 
checkboxes for in Xcode when you create 
properties? 

The transient checkbox indicates 
that Core Data doesn’t need to load or 
save that property. Transient properties are 
typically used to hold values that you only 
want to calculate once for performance or 
convenience reasons, but can be calculated 
based on the other data you save in the 
Entity. If you use transient properties, you 
typically implement a method named 
awakeFromFetch: that is called right 
after Core Data loads your Entity. In that 
method you can calculate the values of your 
transient properties and set them. 

The indexed checkbox tells Core Data 
it should try and create an index on that 
property. Core Data can use indexes to 



speed up searching for items, so if you 
have a property that you use to look up your 
entities (customer IDs, account numbers, 
etc.), you can ask Core Data to index them 
for faster searching. Indexes take up space 
and can slow down inserting new data into 
the store, so only use them when they can 
actually improve search performance. 

I’ve seen constants declared with 
k's in front of them. Are they different 
somehow? 

Nope. It's just a naming convention. C 
and C++ programmers tend to use all caps, 
while Apple tends to use the lowercase “k” 
instead. 

What if I need to use a type that 
Core Data doesn’t support? 

The easiest way is obviously to try 
and make your data work with one of the 
built-in types. If that doesn’t work, you create 
custom types and implement methods to 
help Core Data load and save those values. 
Finally, you could stick your data into a 
binary type (binary data or BLOB) and write 
some code to encode and decode it at 
runtime. 

What other types of persistance 
does Core Data support? 

Core Data supports three types of 
persistence stores on the iPhone: Binary 
files, SQLite DBs, and in-memory. The 


SQLite store is the most useful and what 
we’re using for iBountyHunter. It's also 
the default. Binary files are nice because 
they’re atomic, meaning either everything 
is successfully stored at once or nothing 
is. The problem with them is that in order to 
be atomic, the iPhone has to read and write 
the whole file whenever something changes. 
They're not used too often on the iPhone. 
The in-memory persistence store is a type of 
store that isn’t actually ever saved on disk, 
but lets you use all of the searching, sorting, 
and undo-redo capabilities that Core Data 
offers with data you keep in-memory. 

What SQL datatypes/table 
structures does Core Data use when it 
writes to a SQLite database? 

The short answer is you don’t need to 
know. Even though it’s writing to a SQLite 
database the format, types, and structures 
are not part of the public API and could 
potentially be changed by Apple. You’re 
supposed to treat the SQLite database as 
a blackbox and only access it through Core 
Data. 

So this is a nice GUI and all, 
but I don’t see what this gets us over 
dictionaries yet. It seems like a lot of 
work. 

We had to tell Core Data what kind 
of information we’re working with. Now that 
we’ve done that, we can start putting it to 
work. 
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core data manages objects 


Cere Data XJp Ckse — 

Core l?ata is about mahagihg objects 

So far we’ve talked about how to describe our objects 
to Gore Data, but not how we’re actually going to do 
anything with them. In order to do that, we need to a 
take a quick look inside Gore Data. 

Inside of Gore Data is a stack of three critical pieces: 
the Managed Object Context, the Persistent Store 
Coordinator, and the Persistent Object Store. 
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tab bars and core data 



So, if we want to load or save anything using 
Core Data, we need to talk to the Managed 
Object Context... 



O 


Exactly! 

The question is how do we get data in and 
out of it...? 




The Xcode template we used set up the Core Data stack for us, 
but we still need to figure out how to talk to the Managed Object 
Context. Given what you know about Core Data so far, how would 
you go about asking the framework to load and save data for you? 


Use SQLite commands 


Write custom save and load code to update the data 


Use Core Data to generate classes to do the work for you 
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use core data classes 



The Xcode template we used set up the Core Data stack for us, 
but we still need to figure out how to talk to the Managed Object 
Context. Given what you know about Core Data so far, how would 
you go about asking the framework to load and save data for you? 


Use SQLite commands 


silp 

^ sW.# sV .ouia be aa^ous. 


Write custom save and load code to update the data 


TW，“as W 

U Lso,s .eVe us^ Cove Pa^ ^ 

avoid 一七 kmd °“ 。dc . 


V 


Use Core Data to generate classes to do the work for you 



TW,s is v-eVe M 

and savm^, ^ 


BULLET POINTS - 

■ Core Data is a persistence framework that 
offers loading, saving, versioning and undo-redo. 

■ Core Data can be built on top of SQLite 
databases, binary files, or temporary memory. 

■ The Managed Object Model defines the Entities 

we’re going to ask Core Data to work with. 


■ The Managed Object Context is our entry point 
to our data. It keeps track of active Managed 
Objects. 

■ The Persistent Object Store is part of the Core 
Data stack that handles reading and writing our 
data. 
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tab bars and core data 


Whip up a Fugitive class without 
writing a line 


Xcode can create a Fugitive class from our Managed Object 
Model that we can use like any other class. 



Select the iBountyHunter.xcdatamodel and 
click on the Fugitive Entity 

You need to have a Gore Data entity selected before 
you ask Xcode to generate a class for you. 




Create a new Managed Object Class... 

Select File—New File... There will be a new type 
of file that you can add, the Managed Object 
Class. Select this file and click Next. 









Object CUss. 



...based on the Fugitive Entity 

You will be asked which entity you want to create 
and you should select Fugitive. Click Finish. 



丁 Wis W»ll 

shovj Y 。 认 

“tvUs available- 
\Afe ovxIy V^avc 
SO 七 ^ 



And generate the .h and .m 

Click Finish and you should have a Fugitive . h 
and a Fugitive . m added to your project. Go 
ahead and drag these up to the Classes group. 
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generated fugitive class 


Our generated Fugitive class matches 
our Managed Object Model 

Xcode created two new files from our Fugitive entity: a Fugitive.h 
header file and a Fugitive.m implementation file. Open up both files 
and let’s take a look at what was created. 

TV,e ^ dlass 


is a 




#import <CoreData/CoreData.h> 


@interface Fugitive : NSManagedObj ect 



Qproperty (nonatomic, retain) NSDecimalNumber * bounty; 
Qproperty (nonatomic, retain) NSString * name; 

Qproperty (nonatomic, retain) NSString * desc; 

Qproperty (nonatomic, retain) NSNumber * fugitivelD; 




i\\t tlass?!?! 


Fugitive.h 




NSManagedObject handles storage and memory for 
generated properties 

The generated Fugitive class has properties for name, description, etc., but no fields 
in the class. The Gore Data framework (and NSManagedObject in particular) are 
responsible for handling the memory associated with those properties. You can 
override this if you want, but in most cases this does exactly what you need. 


Tilings get even 
more interesting 
in Fugitive.m •“ 
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tab bars and core data 


There s no code in there either... 
but rm guessing that I*m not going 
to need to worry about that? 



Right! The Core Data framework 
takes care of it. 

The Fugitive.m class is nearly empty, and 
instead of synthesizing the properties, they’re 
declared with a new directive, @dynamic. 


NSManagedObject also implements the properties 


#import ''Fugitive • h 〃 

@implementation Fugitive 

Qdynamic bounty; 

@dynamic name; 

@dynamic desc; 

@dynamic fugtivelD; 


@end 




Fugitive.m 


TV^c •，— cwcwbaW 
J? 七 tlass 

,s almost 

㈣ 七 7! 


The new @dynamic directive tells the compiler not to worry about the getter and setter 
methods necessary for the properties. They need to come from somewhere, though, or else 
code is going to crash at runtime when someone tries to access those properties. This is 
where NSManagedObject steps in again. Because NSManagedObject handles the memory 
for the fields backing the properties, it also provides runtime implementations for the getter 
and setter methods. By having NSManagedObject implement those methods, you get a 
number of other neat benefits: 


o 


The NSManagedObject knows when properties are changed, can 
validate new data, and can notify other classes when changes happen. 

NSManagedObject can be lazy about fetching property information 
until someone asks for it. For example, it does this with relationships to 
other objects. 

NSManagedObject can keep track of changes to properties and 
provide undo-redo support. 


Y<>u get all <^P 

this without 
w\ritihg a I'rne o( 

dodc/ 



Now it’s just a matter of asking Core Data to loact a Fugitive... 
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NSFetchRequests 


Use an NSFetchRcquest to 
describe your search 


In order to tell the Managed Object Context what we’re 
looking for, we need to create an NSFetchRequest. The 
NSFetchRequest describes what kind of objects we want 


to fetch, any conditions we want when it fetches them (like 
bounty > 1,000)，and how Gore Data should sort the results 



Ask the Managed Object Context to fetch 
data using your NSFetchRequest 

All that’s left is to ask the Managed Object Context to 
actually execute your NSFetchRequest. That means we’ll 
need a reference to a Managed Object Context. Fortunately, 
the template set up one for us in the App Delegate. We can 
get to it like this: 




Ewtity Iwfo 


\於 一 


Predicate 


\ 



you yro\/\dc a 
七 describes dWVticms 
i\\t entities must meet 
七 all, so 、 
-fov us. 


Sort descriptor 



丁 sort 

data He 



iBountyHunterAppDelegate *appDelegate = 

(iBountyHunterAppDelegate*)[[UIApplication sharedApplication] delegate]; 
NSManagedObj ectContext *managedObjectContext = 
appDelegate.managedObjectContext; 
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tab bars and core data 


NSFetchRequest *request = [[NSFetchRequest alloc] init]; 

NSEntityDescription *entity = [NSEntityDescription 
entityForName : @"Fugitive" inManagedObjectContext : managedObjectContext] 
[request setEntity: enti 沙 ⑽ ^ ^ 

ky 咖 c, a 

NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] 
initWithKey : @"name" ascending:YES]; - 

NSArray *sortDescriptors = [[NSArray alloc] 
initWithObjects:sortDescriptor, nil]; 


lAfe _ 七七 ^ P—tWc 

so\rtcd al^alDct^al'v 


[request setSortDescriptors : sortDescriptors] 

[sortDescriptors release]; 

[sortDescriptor release]; 

NSError *error; 

NSMutableArray *mutableFetchResuits = [[managedObj ectContext 
executeFetchRequest : request error : &error] mutableCopy]; 

if (mutableFetchResuits == nil) { 

// Might want to do something more serious.•• 

NSLog(@"Can't load the Fugitive data!"); 

} All ask ouv 


[mutableFetchResults release]; 
[request release]; 


yve us katk \rcsul-ts m 
3y\d uf ouv vc*fcv-cir\dcs. 



Now, where do we put all of this code? And 
where are we going to store the results? What 
about actually displaying the fetched data? 
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brain barbell solution 


Now, where do we put all of this code? And 
where are we going to store the results? What 
about actually displaying the fetched data? 

Sihdc Bob is *to bo see his list as sooy\ ds his view shows up, 

Code heeds *bo go m*to vicwW/illAppcav *m Fu^i-tivc^iey/Coh-tv-ollcr.m. 

As -for s-tor'mg results, well yt badk ar\ array, bu*t >wc release i*t ri^K*t a>way. Wt 
Y\ttd bo keep a vc-fcvchdc *bo avray *m ouv view dorrbrollev. 

I 灼 order bo dd*bually show -this dd*bd ； weVc ^o*m^ *to ^ecd *to i^plemeh*t *thc 
dcllFo\rRoy/A'tl^dic^Pa*th *to pull {he ddid -from -the array. 



^Sharpen your pencil 




Let’s get all of these pieces into the app. 



Create the mutable array to hold the fetched items. 

Create an array in the Fugitive Vie wController called items to 
hold the results of the fetch. Don’t forget to synthesize the property 
and clean up memory. 



Import the appropriate headers into 
FugitiveViewController.m. 

Make sure that you #import headers for the App Delegate and 
the Fugitive classes into FugitiveListViewGontroller.m. 



Implement the fetch code inside viewWillAppear. 

Take what we learned on the previous couple of pages and get the 
fetch working. You’ll need to get the Managed Object Context from 
the delegate, create the fetch, then execute it. Remember to update 
the code to actually hang onto the results by assigning them to the 
array we just created. 
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tab bars and core data 


TaUe Cell Magnets 

Use the code snippets below to customize the table 
cells for the fugitive list. 


(UITableView *)tableView { 

return 1; 

} 

// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection: 
(NSInteger)section { 


// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath: 
(NSIndexPath *)indexPath { 


UITableViewCell *cell = 

Cellldentifier]; 

if (cell — nil) { 

cell = [[[UITableViewCell alloc] initWithStyle : 


autorelease]; 


// Set up the cell... 

return [items count]; | 


return 

cell; 


=fugitive. name; || 


Fugitive *fugitive 


UITableViewCellStyleDefault reuseldentifier : Cellldentifier] 


tableView dequeueReusableCellWithldentifier 


#pragma mark table view methods 


cell•textLabel.text 


1 — 


(NSInteger) numberOfSectionsInTableView : 
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sharpen solution 



It’s a lot of code to implement, but when you’re done. Core Data 
will be fetching the data you need for the fugitive list. 



Create the mutable array to hold the fetched items. 


#import <UIKit/UIKit•h> 

Qinterface FugitiveListViewController : UITableViewController { 

NSMutableArray *iterns; 



Qproperty(nonatomic , retain) NSMutableArray *iterns; 

@end 


FugitiveListViewController.h 


Import the appropriate headers into 
FugitiveV iewController.m. 



#import ''FugitiveListViewController. h 

#import ''iBountyHunterAppDelegate . h 
#import ''Fugitive .h 〃 

@implementation FugitiveListViewController 

@synthesize items; 




- (void)dealloc 



FugitiveListViewController.m 
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tab bars and core data 



Implement the fetch code inside viewWillAppear. 


- (void) viewWillAppear:(BOOL)animated { 

[super viewWillAppear : animated]; 
iBountyHunterAppDelegate *appDelegate = 

(iBountyHunterAppDelegate*)[[UIApplication sharedApplication] delegate] 
NSManagedObj ectContext *managedObjectContext = appDelegate. 
managedObjectContext; 

NSFetchRequest *request = [[NSFetchRequest alloc] init]; 
NSEntityDescription *entity = [NSEntityDescription 
entityForName : ©"Fugitive" inManagedObj ectContext : managedObj ectContext]; 
[request setEntity:entity]; 

NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] 
initWithKey : @"name" ascending:YES]; 

NSArray *sortDescriptors = [[NSArray alloc] 
initWithObjects:sortDescriptor, nil]; 

[request setSortDescriptors : sortDescriptors]; 

[sortDescriptors release]; 

[sortDescriptor release]; 

NSError *error; 

NSMutableArray *mutableFetchResults = [[managedObjectContext 
executeFetchRequest : request error:&error] mutableCopy]; 
if (mutableFetchResults == nil) { 

// Handle the error. 


self.items = mutableFetchResults 
[mutableFetchResults release]; 
[request release]; 


.你 


FugitiveListViewController.m 
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magnets solution 



TaWe Cell Magnets Solution 

Use the code snippets below to customize the table 
cells for the fugitive list. 


#pragma mark table view methods 


- (NSInteger) numberOfSectionsInTableView : 


return 


(UITableView *)tableView { 


// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection: 
(NSInteger)section { 

return [items count]; \ 


// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath 
(NSIndexPath *)indexPath { 



tableView dequeueReusableCellWithldentifier 


UITableViewCell *cell = 

Cellldentifier]; 

if (cell == nil) { 

_cell = 「「 「UITableVi 1 allnnl i n i -hTAf-i -hh.c：-h wl ^ : 


UITableViewCellStyleDefault reuseldentifier:Cellldentifier autorelease]，• 



// Set up the cell. 



return cell; 




objects. No ^ _ 一 … 


this! 




To completely wire up your table view, in Interface Builder make sure 不 
that the table view in the Fugitive List has its datasource as the 
FugtiveListViewController. w 
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tab bars and core data 


Match each Gore Data concept to what it does. 


McinAg^cl Object Model 

Describes the search you want to execute on 
your data. Includes type of information you 
want back, any conditions the data must meet, 
and how the results should be sorted. 

WSMcUiclg^clObject 

Responsible for keeping track of managed 
objects active in the application. All your fetch 
and save requests go through this. 

McinAg^cl object Context 

Captures how data should be sorted in a generic 
way. You specify the field the data should be 
sorted by and how it should be sorted. 

NSFetcJiIlecfuest 

Describes entities in your application, including 
type information, data constraints, and 
relationships between the entities. 

NSSortDescrlptor 

A Objective-G version of a Core Data entity. 

Subclasses of this represent data you want to 
load and save through Gore Data. Provides the 
support for monitoring changes, lazy loading, 
and data validation. 


you are here ► 


351 







who does what solution 



备 9 办蕈孓一# w 灰 1 r ， - 


Match each Gore Data concept to what it does. 



Describes the search you want to execute on 
your data. Includes type of information you 
want back, any conditions the data must meet, 
and how the results should be sorted. 


Responsible for keeping track of managed 
objects active in the application. All your fetch 
and save requests go through this. 


Captures how data should be sorted in a generic 
way. You specify the field the data should be 
sorted by and how it should be sorted. 

Describes entities in your application including 
type information, data constraints, and 
relationships between the entities. 


A Objective-G version of a Core Data entity. 
Subclasses of this represent data you want to 
load and save through Gore Data. Provides the 
support for monitoring changes, lazy loading, 
and data validation. 
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tab bars and core data 


Here's a URL for the data I'm 
getting. Turns out I can do that 
instead of getting that paper list 
from the court... 


O 


You’ll need to download your 
copy of the fugitive list. 

Browse over to http://www.headfirstlabs.com/ 
iphonedev and download iBountyHunter.sqlite. 
Right-click on the iBountyHunter project 
and select Add —Existing Files..., and 
make sure it is copied into the project. 






How do we tell Core Data to load 
from this file? 
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databases are resources 


Add the database as a resource 


We have all of this code already in place to load data — it came 
with the Gore Data template. But how do we get from there to 
actually loading the database? 



h^dled the ⑽ 
the ruji-tivc Class. 


Now y\ccd *to look 3 *t 
侁 c oi\\tr c^d. lA/c 於 cd 

^ Cov-c Pata t> 

ouv Fu^*twc Pa*ta^ asc， 


Pack to the Core Pata stack 

Remember the Gore Data stack we talked about earlier? We’ve gotten 
everything in place with the Managed Object Context, and now we’re 
interested in where the data is actually coming from. Just like with the 
Managed Object Context, the template set up the rest of the stack for us. 



so Y/c tan leave CoordmaW as is. 


。於畔』 c k anally ^adm 3 

一 i\>c ^ data- T^U 

>wc y\ccA -b look. 


Let’s take a look at tke template cocte in tke App Delegate... 


354 Chapter 7 













tab bars and core data 


The template sets things up for a SftLite PP 

The Gore Data template set up the Persistent Store Coordinator to use a 
SQLite database named after our project. As long as the database is named 
iBountyHunter.sqlite, then Gore Data should be ready to go. 


- (NSPersistentstoreCoordinator *)persistentStoreCoordinator { 

if (per sis tents toreCoordinator ! = nil) { The *tc^p/a-tc sets *th* 

return per sis tents toreCoordinator; up -to use 9 

} & 一把 m 二： 此 

NSURL *storeUrl = [NSURL fileURLWithPath: [ [self 

applicationDocumentsDirectory] stringByAppendingPathComponent : 
@’’iBountyHunter.sqlite’’]]; 

NSError *error = nil; 

persistentStoreCoordinator = [[NSPersistentstoreCoordinator alloc] 
nitWithManagedObjectModel : [self managedObjectModel]]; 




if ( ! [persistentStoreCoordinator addPersistentstoreWithType : NSSQLite 
StoreType configuration : nil URL : storeUrl options : nil error : terror]) 

NSLog(@^Unresolved error %@, %@〃， error A [error userlnfo])/ 


abort (); 


return persistentStoreCoordinator 


Tk adds a 

0\>\cti SW bo too^rdma-bov- 






iBountyHunterAppDelegate.m 


Tesr DriVq 


Now that the database is in place, and the Persistent Object 
Store can be used as-is, go ahead and run the app. 
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test drive solution 




TesT DriVq 



Wkere is tke data? 
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tab bars and core data 



O 


We added the database to the project. 
The code looks right. This all worked with 
DrinkMixer. Whafs the deal?? 


Core Data is looking somewhere else. 

Our problem is with how Core Data looks for the 
database. Well, it’s actually a little more complicated 
than that. 


iPhone Apps arc read-only 

Back in DrinkMixer, we loaded our 
application data from a plist using the 
application bundle. This worked great and our data 
loaded without a problem. But remember how we talked about how 
this would only work in the simulator? It’s time to sort that out. As part 
of iPhone security, applications are installed on the device read-only. 
You can get to any resources bundled with your application, but you 
can’t modify them. The Gore Data template assumes you’re going 
to want to read and write to your database, so it doesn’t even bother 
checking the application bundle. 






NSURL *storeUrl = [NSURL fileURLWithPath: [[self 

applicationDocumentsDirectory] stringByAppendingPathComponent : 
iBountyHunter.sqlite^]]; 


// 




iBountyHunterAppDelegate.m 


We neect to take a closer look at kow 
tkose directories are set up … 
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iPhone app sfmcfure 


The iPhowc's application structure defines 
where you can read and write 


For security and stability reasons, the iPhone OS locks down the filesystem 
pretty tight. When an application is installed, the iPhone OS creates 
a directory under /User/Applications on the device using a unique 
identifier. The application is installed into that directory, and a standard 

directory structure is created for the app. ^ ㈣ ⑸挪 蛉 ^lled ^ 如二 

uy>1 auc IP (_P) “如 a?? 

Home . I 

TV app s^cd m a 

， Bou^yttu^.app atW Lavv, cU- a^c all sWd 

dirttbor^ is 代 ad -。⑹ 10 … 


o 



Do 匕 umerrU 





P\rc-fc\rc^^cs 


Uc Podum^ts UWary d.^Wics arc 
read - Wrte ^ affkalicw and also backed 

Uf by iTuncs y/V^c^ usev S^/US dev’itc. 
TWis is wV^crc user data y^ccds -to 30 . 


Caches 


Tk * U ? 細 W / •丨 s 代 ad 增如 * to 。, 
W 七 .,U backed ^ <Wi 吒 a 
T\{\s da-ta tould be deleted ai t»» 


Use the Pocuments directory to store user data 

Since most Gore Data applications want to read and write data, the template 
sets up our Gore Data stack to read and write from the Documents directory. 

An application can figure out where its local directories are by using the 
NSSearchPathForDirectoriesInDomains, just like the template does in the App Delegate: 

- (NSString *)applicationDocumentsDirectory { 

return [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, 
NSUserDomainMask, YES) lastObj ect]; 
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tab bars and core data 


Copy the database to the correct place 

When the application first starts, we need to check to see if there’s a 
copy of the database in our Documents directory. If there is, we don’t 
want to mess with it. If not, we need to copy one there. 


v/oull bo deltas 
method 



- (void)createEditableCopyOfDatabaseIfNeeded { 

// First, test for existence - we don't want to wipe out a user's DB 
NSFileManager *fileManager = [NSFileManager defaultManager]; 

NSString *documentsDirectory = [self applicationDocumentsDirectory]; 
NSString *writableDBPath = [documentsDirectory stringByAppendingPathCompo 
nent : @"iBountyHunter.sqlite"]; 

BOOL dbexists = [fileManager fileExistsAtPath : writableDBPath]; 
if (!dbexists) { 

// The writable database does not exist, so copy the default to the 
appropriate location. 

NSString *defaultDBPath = [[[NSBundle mainBundle] resourcePath] stringByA 

ppendingPathComponent : @"iBountyHunter • sqlite"]; ... 

v/c yab i\\t master PB 。吖 

NSErxor *error; bundle] *tWis is vc 3 d—oir\ly 

BOOL success = [fileManager copyltemAtPath : defaultDBPath 

toPath : writableDBPath error : &error]; 个 1 七 -fv-ow v-cad-o^ly *to 

、- - 1 . 


%@ 


if (! success) { ^ - 一 y/v-i-tafelc 

NSAssertl(0, @"Failed to create writable database file with message 
、’ ’，[error localizedDescription]); 




- (void)applicationDidFinishLaunching : 
(UIApplication *)application { 

[self createEditableCopyOfDatabaselfNeeded]; 



iBountyHunterAppDelegate.m 


I Now that the app knows how to copy the database, you need 
7F to uninstall the old version of your app to delete the empty 
database that Core Data created earlier. When you build and 
run again, our new code will copy the correct DB into place. 
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that’s a lot of perps 




Tesr DriVq 


Now that the app knows where to find the 
database, it should load. 


/\11 da-ta 

\s *m -bV^cvc! 




ii.ClFTHf 


3.D4 PM 


George Palin 
Henry Lewis 

Sweeney 


SXol eit 


Jackscn Jones 


Jennifer Mai 


Jim McCarthy 
Jim 5m]ley- 
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tab bars and core data 


Why didn’t we have to do all of 
this directory stuff with the plist in 
DrinkMixer? 

We only ran DrinkMixer in the 
simulator, and the simulator doesn’t enforce 
the directory permissions like the real device 
does. We’d basically have the same problem 
with DrinkMixer on a device. The reason this 
was so obvious with iBountyHunter is that 
Core Data is configured to look in the correct 
place for a writeable database, namely the 
application’s Documents directory. 

How do I get paths to the other 
application directories? 

Just use 

NSSearchPathForDirectoriesInDomains 
but with different NSSearchPathDirectory 
constants. Most of them you won’t ever 
need; NSDocumentsDirectory is the most 
common. You should never assume you 
know what the directory structure is or how 
to navigate it; always look up the specific 
directory you want. 

So what happens to the data when 
someone uninstalls my application? 



When an application is removed from 
a device, the entire application directory is 
removed, so data, caches, preferences, etc., 
are all deleted. 

The whole Predicate thing with 
NSFetchRequest seems pretty important. 
Are we going to talk about that any more? 

Yes! Well come back to that in Chapter 8. 

So is there always just one 
Managed Object Context in an 
application? 

No, there can be multiple if you want 
them. For most apps, one is sufficient, 
but if you want to separate a set of edits 
or migrate data from one data source to 
another you can create and configure as 
many Managed Object Contexts as you 
need. 

I don’t really see the benefit of the 
Persistent Store Coordinator. What does 
it do? 

Our application only uses one 
Persistent Object Store, but Core Data 


supports multiple stores. For example, you 
could have a customer information coining 
from one database but product information 
coining from another. You can configure two 
separate persistent object stores and let the 
persistent store coordinator sort out which 
one is used based on the database attached. 

How about object models? Can we 
have more than one of those? 

Yup—in fact we're going to take a look 
at that in Chapter 8. 

Do I always have to get my 
NSManagedObjects from the Managed 
Object Context? What if I want to create a 
new one? 

No, new ones have to be added 
to the context—however, you can’t just 
alloc and init them. You need to create 
them from their entity description, like this: 
[NSEntityDescription insertNewObjectForEnt 
ityForName:@”Fugitive” inManagedObjectCo 
ntext:managedObjectContext]; 

That will return a new Fugitive instance and 
after that you can use it like normal. 
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building the detail view 



Now we need to build the 
detail view, right? 


Exactly. 


We have the database loading with 
detailed information, but the user can’t 
see it yet. Now, we just needto build out 
the detail view to display that information 
as well. 


YouVc dlmos 七 Aor\t 
youv lis 七 , 




To po Ust 


夕 /W you 

kr>oy/ how *fco d 
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tab bars and core data 


jSK^： 


fjynt ExgrciSg 


Building the detail view isn’t anything new for you—so get to it! Here is 
what you’re working with from our earlier sketch for the detail view. 


□ 

□ 

□ 


Create a new view controller and nib called the FugitiveDetailViewGontroller. 
Lay out the nib using Interface Builder to have the fields we need. 


Then update the new view controller to have outlets for the fields we’ll need to set and a 
reference to the Fugitive it’s displaying. 



Fu A vc 卜 ,ID, Bou，U 

sii ^r iy va,uc su,d 


TV\\s is for v\oics av\d 
de-tails about -fuy-tWc 


- Carrier 






PM 




ru^i-tivc 

Fugitive IV^ 


Tk dcla.l v\cv/ U tacM 如 11 

fee available ky tkk 中以吖 


M oU^ UAs sWld be 代 ad - 

0 v,lY smdc v/c Aoy^i usc^rs 
七 Y/cak.wW^ bouses. 


㉟ 工卜 1 ‘Id 

7 T ^il/iew. Thai 

= V ， — 

0,,,h 3 H 


OUh 


(Fuc^ijives 


Caf-turcd 


TV\c value o( *tV^c 
bou^Y Will fee V^cvc. 
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long exercise solution 



ExeRdSe 

OLut\OA 


Go through and check the code, outlets, 
declarations, and dealloc. 


The files that you need for the new view are: 
FugitiveDetailViewController.h, FugitiveDetailViewController.m, and 
FugitiveDetailViewController.xib. 

To create them, just select File ^ New and check the box that says 
"With XIB for User Interface". After that, you’ll need to move the .xib file 
into /Resources within Xcode. 
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tab bars and core data 


@class Fugitive; 

Qinterface FugitiveDetailViewController : UlViewController 

Fugitive *fugitive; 

UILabel *fugitiveNameLabel; 

UILabel *fugitiveIdLabel; 

UITextView *fugitiveDescriptionView; 

UILabel *fugitiveBountyLabel; 

} 

Qproperty (nonatomic, retain) Fugitive *fugitive; 


©property (nonatomic, retain) 
Qproperty (nonatomic, retain) 
©property (nonatomic, retain) 
©property (nonatomic, retain) 

@end 


IBOutlet UILabel *fugitiveNameLabel; 

IBOutlet UILabel *fugitiveIdLabel; 

IBOutlet UITextView *fugitiveDescriptionView; 
IBOutlet UILabel *fugitiveBountyLabel; 


FugitiveDetailViewController.h 


#import ''FugitiveDetailViewController. h" 

#import ''Fugitive .h 〃 

@implementation FugitiveDetailViewController 

@synthesize fugitive, fugitiveNameLabel, fugitiveldLabel, 
fugitiveDescriptionView , fugitiveBountyLabel; 
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long exercise solution 











ExeRciSe 

LutiOH 


Now build the view in Interface Builder. 


"tV^C C.om^oirtC^'ts ok t 

如 detail vicv/. 


A ^ rs 


fcJ 画 

View Mwk 


F li giti^e Detail Viev^Conlml ler.xib 


Cl " 

ln&pt!LLfiF Fteld 


Name 


IVPt 


lake suve 七 hat 
11 of 払 c added U 
： lcmc^ avc 6W ， W … 

mam v ， cv/. 



• Fin I Mi 庐 flndlr 
Vksw 

liht\ llugilivc _mel 
jp _ Ljbi'i ^Fugillvc IDyf) 

■ ext Vi«cw 
Librl liauuly,} 
LdbehiLWCMJDUl 


0 itiau5tvHunl£r.xco4epiBj 






Use {ht msfcd-tov- *to i\\t 
dic-faul*t values <Jc c3^ <Jc *t^csc 
clcw>cr\*b -to w Fu5»*tivc Na^c > 

IP W > cbt- 



^kc su\rc you hook 
all these up... 


hrvrDif IqiilVicwCgiil mil 蜃 ■ 


FileS 


ooooo-f^w 
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tab bars and core data 


label ^v-om 


To get the simulated ^avigatioh bav-, m 
七 he (hspcdW set the top bav-, simulated 

m 七饮 ^ clcr^cht ^avigatioh Bav w 




View 


: Xi 



i\\t value- 



Fugjli 明 M^me> 

Fu^bw to* 

Lf>rcJn ip^um dolor sil or cl it 
lamel, cgnaecl^laiur allium 
p^clj, iw%d do 

oiusmod temper incididunl ut 
labors el dolors magna 
atiqm Ul fif\\m minim 
v^niam, quig no^tmd 

Bounty: SI ,000,000 


T\\tst avc 
labeU, W 七 Aa 呼 
七 V^c -fo^*b 
IP # 12 - ?t 


The Tixtl/icw heeds 
"to be upsized "to 
Z 午 O x I 诉 us'm 9 
the ihsped-fcov-. 
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geek bits 



6ee} BifS 


We’re going to add some spit and polish to 
this view. It's fine the way it is, but here’s 
some iPhone coolness to add. 


Ah 


View 


•v 


Add a \rouy\dcd 

button， 

ov> 七 ^ 

U|Tcx.*t\/^- 


Fugitive Name 

F'jp.' v* ilw 

Ljot^iti ipsum ckiEqr nr rIjE 

FniTiBt!. con^&cEHtR：Lir cillium 

wlipi^icing pecu. sE?d dn 
eiuarnod temper incididunE ut 
labors ct itoF^rc magns 
ali^iia, Ut orim ad minim 
vcfnlam. q^s wtrud 

Bounty- $1 .⑽ ).000 


We’ll make this button function as a 
border. To do that, you need to do 
two things: 



Double-click on the 
rounded rectangular button, 
then go to the Layout 
Send to Back menu 
option. 



With the button still 
selected, use the inspector 
to uncheck the enabled 
box (under content). 
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tab bars and core data 



Now, just populate the detail view from the Fugitive 
List. You know how to do this from what we did earlier 
with DrinkMixer. 



You should be able *to 

-f igure OU*t OY\C- 


The other files need to know that the detail view exists. 

.irrsoin^implementation file, you’ll need to #import 
F ugitiveD etailViewG ontroller.h. 



The detail view needs to get called. 

In that same implementation file, the table view needs some selection 
code. It’ll be similar to the code that we used in DrinkMixer. 



The fields need to be populated with the data. 

The detail view code needs to populate the existing fields with the data 
from the fields that were set up with the Fugitive.h and Fugitive.m 
classes and the Core Data code. In viewWillAppear : 


fV>ese ave jwst a dowfl ^ fuji 
bu*t should jWc 

you all d 


tiveNameLabel.text 


fugitiveldLabel•text 


=fugitive.name; 

[fugitive.fugitiveID 


stringValue]; 


O Wire it up. 

Go back into IB and link your table view to its delegate. 
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populate the detail view 



E^eRciSe 


Now, just populate the detail view. You know 
enough from before to do this. 



The other files need to know that the 
detail view exists. 


Just add tw.s -to 

Fucx»tivcUst\/*«CY/Co^ollcv.m A-.lc. 

❺ 


In some implementation file, you’ll need to 
#import FugitiveDetailViewGontroller.h 


The detail view needs to get called. 

In that same implementation file, the table view 
needs some selection code. It’ll be similar to the 
code that we used in DrinkMixer. 


- (void) 

tableView : (UITableView*)tableView didSelectRowAtlndexPath : (NSIndexPath 
*)indexPath { 


FugitiveDetailViewController *fugitiveDetailViewController 
=[[FugitiveDetailViewController alloc] initWithNibName : 
@’’FugitiveDetailViewController" bundle:nil] ; Hcv-c tell 

r 14r 

: ^elf.sterns 七士 # 

objectAtlndex : indexPath.row]; 


fugitiveDetailViewController.fugitive 


[self.navigationController pushViewController : 
fugitiveDetailViewController animated : YES]; 

[fugitiveDetailViewController release]; 


should 

d» 邛 la7. 



FugitiveListViewController.m 
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tab bars and core data 


◦ The fields need to be populated with the data 


#import ''FugitiveDetailViewController.lv 

#import ''Fugitive .h" f 一 ^ _ 


joihj -to be aucssi^ fields m 
the Fugitive dass. \Nt heed -to -tell 
the dompilcv about it 


@implementation FugitiveDetailViewController 

Qsynthesize fugitive, fugitiveNameLabel, fugitiveldLabel, 
fugitiveDescriptionView, fugitiveBountyLabel; 

hAA\r\( 

end -these two de^lav-ai'u 

handles -the -Pad that ihey 赠 t 

[super viewWillAppear : animated] ; v\oi stv-mgs, but NSKumbcv a^d 

^S^Ctinr» 3 l^unr»bc\rs. 


- (void) viewWillAppear:(BOOL)animated { 


巧 sVmgl/aluc oh the 

>t these i.v/o 


fugitiveNameLabel.text = fugitive.name; 
fugitiveldLabel. text = [fugitive • fugitive ID stringVaJ.ue]; 
fugitiveDescriptionView.text = fugitive.desc; 
fugitiveBountyLabel.text = [fugitive.bounty stringValue]; 


.眯 


FugitiveDetailViewController.m 

Wire it up. 

In IB, the table view under the Fugitive List View Controller needs to 
have its delegate linked to that View Controller. 


^ ^ ^ 






9 Tibia# Camr^lkr 

n TlblU 

* _ Canli^lir ff ufKivci 

^ Niwi^mJban bi 
* |Q Fw^fUifi |i^| 



3 <nn> 


a — 1 

OEf ^JTClfptid 
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test drive 




Tqst DriVQ 


After populating the detail view, you can see 
the information about each fugitive. 



The badk button is wo\rk*mg iha^ks {o 
the i^av dojvbrol. 




PH 


Hovj ah 

^i^ry be 
s dcdcd ih -the 


View. 


Henry 


Hunter Swfpensy 


I. Stol ^El 


Jackson Janes 




Jim McCarthy 
Jim Smiley 


Joe Daniels 


TVic labels 
Vidve bccr\ 
v-cfla^cd 
y/i*bii values 
-from 
database. 


It all works! 
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tab bars and core data 


It works great! Having all that 
information with me makes it much 
easier to catch outlaws. I should be 
able to almost double my business 
with this app! 


Great! 

After a couple of weeks, Bob is back 
with a new request... 


That really worked! Ive 
caught a ton of people already! 
How can I keep track of who 
Ive caught? 


To be continued... 



you are here ► 


373 



coredatacross 



CoreDafacross 

There’s a lot of terminology with Core Data ； let’s 
make sure you remember it! 



Across 


Down 


2. Each app has a_directory. 

5. NS_Descriptor captures how data should be sorted. 

6. In the middle of the Core Data stack is the Persistent Store 


7. The_template is pretty basic. 

8__can manage different types of data. 

10. The managed object_is the top of the Core 

Data stack. 

11. NSFetch describes a search. 


1. The Persistent Object Store is at the_of the 

Core Data stack. 

3. Core Data has_and redo. 

4. The_controller is good for switching views. 

9. The managed_model describes entities. 
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tab bars and core data 


Your Core Pata Toolbox 

You’ve got Chapter 7 under 
your belt and now you’ve 
added Core Data to your tool¬ 
box. For a complete list of tooltips in 
the book, go to http://www.headfirstlabs. 
com/iphonedev. 



TaV> Bavs 

㈣ 妯一 s a sc?avdU 


TKc Pata Modt\ 

lA/ov^ks y/i-tK entities i\\ai V>avc 

^V"O^CV"*t»CS ddllcd 3*t*tv»bu*tcs. 

Can be edited divc^ly m )<^odc- 
Has scvcv-al di-f-fcv"c^*b da 七 a types. 


Cove p 3 *t 3 

Pvovidcs 3 s*t3dk 七 1 ^七 n\Bv\3^CS *t^C 
da*t3 so you do^*t have *to. 

Ca” ma 於 ay ty\>cs of 

da*ba. 

^V"C 3 *t *foV mCW'OV'Y 
a^d *bra 6 ki% dKa^cs. 




BULLET POINTS 


■ 


■ 


■ 


Core Data is a persistence framework that 
offers loading, saving, versioning and undo-redo. 

Core Data can be built on top of SQLite 
databases, binary files, or temporary memory. 

The Managed Object Model defines the Entities 

we’re going to ask Core Data to work with. 


■ The Managed Object Context is our entry point 
to our data. It keeps track of active Managed 
Objects. 

■ The Managed Object Context is part of the Core 
Data stack that handles reading and writing our 
data. 


l mdvs 
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coredatacross solution 



CoreDatacross Solution 

So, did you remember all those words? 



Across 

2. Each app has a_directory. [DOCUMENTS] 

5. NS_Descriptor captures how data should be sorted. 

[SORT] 

6. In the middle of the Core Data stack is the Persistent Store 
_. [COORDINATOR] 

7. The_template is pretty basic. 

[WINDOWSBASED] 

8. _can manage different types of data. 

[COREDATA] 

10. The managed object_is the top of the Core 

Data stack. [CONTEXT] 

11. NSFetch_describes a search. [REQUEST] 


Down 

1. The Persistent Object Store is at the_of the 

Core Data stack. [BOTTOM] 

3. Core Data has_and redo. [UNDO] 

4. The_controller is good for switching views. 

[TABBAR] 

9. The managed_model describes entities 

[OBJECT] 


376 Chapter 7 







































































8 migr^iting and optimising with core data 


肴 

Things are changing 

參 





We have a great app in the works. 


iBountyHunter successfully loads the data that Bob needs and lets him view the fugitives 


in an easy way. But what about when the data has to change? Bob wants some new 


functionality, and what does that do to the data model? In this chapter you’ll learn how 
to handle changes to your data model and how to take advantage of more Core Data 
features. 


this is a new chapter 
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bob wants to get paid 


Pob needs documentation 



Bob needs to record 
more information. 

Bob has to keep track of his 
work so he can be paid. That 
means that we need somewhere 
to store the day and time of a 
capture and then use that to 
build the captured view... 



v，cw wc ihc last 


How are we goingf to upctate 
iBountyHunter to kanctle tke 
new information? 
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migrating and optimizing with core data 


r ^^rpen your pencil_ 

_ ^ We need to figure out how to update iBountyHunter 

to handle this new data. Look at each piece of our 
application and write what, if anything, needs to change. 





Where do we start? 
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start with the new data 



We need to figure out how to update iBountyHunter 
to handle this new data. Look at each piece of our 
application and write what, if anything, needs to change. 



一 A sp 。 七 *b> mark 
-fu^i-tivcs as 

一 Show date 

o-f daj>*tu\rc. 

一 Populate {he dap*tu\red 
list- 



- Add a dap*tu\rcd -flaj 

*bo -fu^i*tivcs. 


一 Add 七 he dap*tu\rcd 
time -fov 七 he -fugitive. 


一 Add *thc dap*tu\red 
dd*be -for -the -fugitive. 



View Controllers 


- Pill m -the da*be ar\d 

hrnt dap*tu\rc da*ba* 

一 Display ohly tKc 
dap*tu\rcd -fugitives *m 
■the dap*tu\rcd view. 



一 Add *m-fo\rma*tioh 
about *thc *(x> 

■the da*ba -for display m 
i\\t app. 


Where do we start? nearly cvcv-y-thmj depends oy \ *thc y \ c ^ da 七 3 

wc Y\ttd *to add ； let’s grt *tha*t m our object model 
-fiv-s*tj we C^y\ update *thc res-t- 
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migrating and optimizing with core data 


Everythiwg stems from our object 
model 

From what we figured out in the exercise, the Fugitive entity 
needs a few more fields: the date and time, and something to 
indicate whether or not the fugitive has been captured. The 
database is built from the data model, so we can just update 
the data model to add the information we need. The Core 
Data date type includes both a date and time, so we only 
need two more properties on our Fugitive entity: 


Sihdc dll -fugitives 
will be Cither 

o\r hot, 

it heeds -fco exist 
-Po\r all o-p -them. 



This pv-ovidcs 
both the date 
the tirwe. 




oh, y ^ ihe 

^diiiv CSj 

its op-tio h a|. 


r ^harpn your pencil 


Update the data model with the new 
captured fields. 

Use the data model editor to update the model with the two new fields. 


After you update the model, you’ll need to delete the two old fugitive 
class files and generate new ones with the new fields included. 
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your updated model 


Sharp your pencil 

Solution 


Use the tools that Xcode comes with to 
quickly make those changes. 

/ 

Use the data model editor to update the model with the two new fields. 

_ a-3 I 「■ 

」 ■ II ^ f_ 

了驟 m Aepwrir^r^in MMmwiW 3 [1 luq lm» P 

MiW ■giiJl __ 

rcrnrnww^w jj 


k. M 


；ol 



U 


Pvqiiyri 


HPrri 

kftkMfn I 


Ti 




M^pi¥rflR 3 


ttcv-cs *tV)C 
f— updated 
tv\hbf 


After you update the model, you’ll need to delete the two old fugitive 
class files and generate new ones with the new fields included. 


^import <CoreData/CoreData.h> 


Qinterface Fugitive 


NSManagedObject 


Qproperty (nonatomic, retain) NSDecimalNumber * bounty 



Make sure 七 youv 
a*t*tvibu*tcs 


ouvs 



©property (nonatomic, retain) NSNumber * captured ;^： 

Qproperty (nonatomic, retain) NSNumber * fugitivelD; 

©property (nonatomic, retain) NSDate * captdate 

Qproperty (nonatomic, retain) NSString * name; 

Qproperty (nonatomic, retain) NSString * desc; 


@end 



iicsc *bwo -field 
Yt *tV^C Y\t^i 
^dr\CV"a*tcd 乙 Ussc 


s. 


Fugitive.h 
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migrating and optimizing with core data 


#import ''Fugitive. h ; 


@implementation Fugitive 


Qdynamic bounty; 

@dynamic captured ; 

Qdynamic fugitivelD; 

@dynamic captdate; 

@dynamic name; 

@dynamic desc; 

@end 



TV^ mw -fields V^avc bee” 
added as properties, 

just like *LV^ cav-l'icv- 


or\CS. 



Fugitive.m 


Tqst DriVQ 


Once you’ve made the changes, go ahead 
and run iBountyHunter. 



今 / > a 

I hmulilBr - 3.1 j Dtbuy T j 


_ it □vfeiLcggnH' CcinTQlr 






it 
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It crasked! 


Why did the app crash? 
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data needs updating 


The data hasn't been updated 


If you take a close look at the console report of the crash, 
you can figure out what’s wrong... 


This cv-\ro\r seems -fco 
be -f\ronf» Co\rc 

Data. 
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database- 
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c 7 

Ouv* ovi^mdl Fu^i*tivc Cv>*ti*ty 
oy>ly had -fouv atbribu 七 《... 


Fugitive 


The data model is different 
than what was used to actually 
write the data. 






v Attributes 

bounty 

captdate 

captured 

desc 

fugilivelD 


Core Pata caught a mismatch between our 
and our model 


We created this problem when we added new fields to the 
Fugitive entity. Our initial fugitive database was created 
with the old model, and Gore Data has no idea where to 
get those new fields from. Rather than risk data corruption, 
it aborted our application with an error. That’s good, but 
we still need to figure out how to fix it. 
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migrating and optimizing with core data 


Pata migration is a common problem 

Realizing you need to add new data or changing the way you store old 
data is a pretty common problem in application development. But just 
because it’s common doesn’t mean it’s easy. Gore Data works hard to 
make sure it doesn’t corrupt or lose any data, so we’re going to have to 
tell it what to do with our new Fugitive entity. 



Managed Object Context 




Persistent Store 
Coordinator 




Persistent Object Store 




^ Attributes 

bounty 

captdate 

captured 

desc 

fugilivelD 

name 



w 
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two data models 


Wc need to migrate the old data into 
the new model 


We made the changes to the data model, but we need everything up 
and down the Core Data stack to be able to deal with those changes. In 
order to do that, we need to migrate the data. 


To migrate anything, you need to go from somewhere to somewhere. 
Core Data needs to have both of these data models to make data 
migration work for the entire stack. We need a new approach to 
changing the data model, besides just changing the old one. Let’s undo 
what we did earlier so we can load the data from the database again. 



DATA MODEL DEMOLIIION 

In order for our data model to have a starting point 
and an ending point, we need to go back into 
iBountyHunter.xcdatamodel and remove the two 



new fields —— for now 

Fn-rjifiw^ 

Delete 

T Attributes 

these Z J 

bounty 

-fields . 〜 

■captured- 


Then GO BACK and CHECK that it's 
working again! It will save lots of 
time and trouble later. 


dese 





Our two models need different versions 


It’s easy enough to change the data model by hand, but Gore Data 
needs to be able to work with both the old and new data. We need to 
give Core Data access to both, but tell them they’re different versions 
of the same model. Even more importantly, we need to tell Core Data 


The Pcvsistcht S-tovc 

khow "this is 

what wc dohsidev- ouV" 
vemsioh. 


which one we consider our current version. 


TVis is what wc siaried 
'with, 3hd the Pcv-sis-tcht- 
SWc is 

this daia model. 


Fji-rjifiwip 


w AUnbul 4 JL 

baumy 

fucjl ivMlin 1 
n jm& _ 

Relationships 



Old data model 
iBountyHunter .xcdatamodel 


- Attributes 

bounty 

c^ptdate 

captures 

dese 




New data model 
iBountyHunter 2.xcdatamodel 
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migrating and optimizing with core data 


Xcode makes it easy to version the data 
model 


Fortunately, it’s pretty easy to create a new version of your data model 
using Xcode: 



Highlight iBountyHunter.xcdatamodel. 

Then go to the Design ~> Data Model ^ Add Model Version menu option. 
That will generate a new directory called iBountyHunter.xcdatamodeld. Under that 
directory, there will be two copies of the data model. 



Set the current version. 

Inside the iBountyHunter.xcmodeld directory, select iBountyHunter 2.xcdatamodel, 
which will be our new version. Go to the Design ^ Data Model ^ Set Current 
Version menu option. 


fW’s what the 
-Pi^al -Pile Iisiih0 

will look like- 




Update the new data model. 

Select iBountyHunter 2.xcdatamodel and re-edit the data model to add back in the 
captdate and captured fields as we did before. Now the old version is preserved and 
the changes are where they belong. 



foe} B 形 


Normally, you’d also need to delete and regenerate the 
Fugitive class, but since we made the same changes to 
the new file, the generated class would be the same. 


How does tke app 
map between tke 
two versions? 
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data migration 



Jim: Ugh. I guess we need to write a bunch of migration 
code or something. 

Joe: Why? 

Jim: I assume we’re going to have to tell Core Data how to 
get from the old version of the data to the new one, right? 

Frank: Well, actually, I think we can do it automatically. 

Jim: What? 

Frank: Gore Data has a feature that allows you to tell the 
app about both models and it can migrate the data for you. 

Jim: Nice! When does the data actually get migrated? 

Frank: Runtime, when the Persistent Object Store sees that 
the data is in the old format. That means that we’ll just need 
some code to tell iBountyHunter to actually do the migration. 

Joe: OK, so it looks like some of that code is auto-generated, 
and some of it needs to be added. 

Jim: This is great; so we can just change whatever we want? 

Frank: There are certain data changes that Gore Data 
can handle automatically, like adding new attributes. More 
complex changes to the data need to be handled manually. 

Joe: Yeah, it says here that we can do automatic migration if 
we’re adding attributes, or changing the optional status of an 
attribute. 

Jim: What about renaming? 

Frank: Renaming gets tricky — sometimes you can and 
sometimes you can’t. 

Joe: So, how can we migrate the data we have? 
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migrating and optimizing with core data 


Core Pata caw "lightly" migrate data 

Lightweight data migration is a powerful Core Data tool that allows you to cleanly 
update your underlying data to match a new data model without needing a mapping 
model. It only works with basic data changes: adding new attributes, changing a 
required attribute to an optional one, or making an optional attribute required with a 
default value. It can also handle limited renaming of attributes, but that gets trickier. 

Automatic data migration happens at runtime, which means that your app needs to 
know that it’s going to happen so that the data can be migrated. You’ll do that in the 
AppDelegate: 


- (NSPersistentStoreCoordinator *)persistentStoreCoordinator 


if (persistentstoreCoordinator != nil) 
return persistentStoreCoordinator; 


Remember, by Core Pata V.ll loadall 

o( okjedt models m youv- aff bundle. Tnat 
*rt Will see botK -tKc old — 釙 d 如 
version o( ouv- model. 


NSURL *storeUrl = [NSURL fileURLWithPath : [[self applicationDocumentsDirectory] 
stringByAppendingPathComponent : @ 〃 iBountyHunter•sqlite〃]]; 

NSError *error = nil; 

persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedOb 
jectModel : [self managedObjectModel]]; 

NSDictionary *options = [NSDictionary dictionaryWithObjectsAndKeys : 

[NSNumber numberWithBool : YES ], NSMigratePersistentStoresAutomaticallyOption, 

[NSNumber numberWithBool : YES], NSInferMappingModelAutomaticallyOption, nil]; 

if (![persistentStoreCoordinator addPersistentstoreWithType : NSSQLiteStoreType 
configuration : nil URL : storeUrl options : options error : &error]) 


1/VcTha^Jcd 七 his -p\rorw ^i |： options {o pass -the 

o^hov\s io -the pcv-sis-tc^tS-tovcCoovdia-fcov- All wc b> do enable 

li 吵吵七 m'ljv-a-tioirt is tu\nr\ 
i*b or\. 


iBountyHunterAppDelegate.m 




Tost DriVq 


After adding the code to the app delegate, Build and Debug... 


|-f you \ru\r\ m*to issues 

BiAild->Clca^ -fiv-s-t, Wd ar\d 
Pcbuj. Stra—y, ><^odc 
always pv-opcv-ly v-ctompilc V’vs 七 

-time you vcv-s\oir\ yoiAV- model, W 七 
£.lcdy\nr\^ should -f ^ 
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test drive 



TesT DriVq 



Awesome! It’s working witk a 
wkole new ctata model. 
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migrating and optimizing with core data 



The Pcvsistcifti Object Stove 右印 ose 』 

This week’s interview: 

Do you really have any 
staying power? 


Head First： Hi Persistent Object Store, mind if I 
call you POS for short? 

Persistent Object Store: I d rather you didn’t. 
Just “Store” is fine. 

Head First： OK, Store, so I understand you’re part 
of the Core Data stack? 

Store： Yep — one of the most important parts, 
actually. It’s my job to read and write your actual 
data. 

Head First: Right, you’re the guy who translates 
into a bunch of different formats. 

Store： Exactly. When you use Gore Data, you 
don’t really need to know if your data is going into a 
simple file or a sophisticated database. You just ask 
me to read and write a bunch of data and I handle it. 

Head First: That’s convenient. I understand you 
can be pretty particular, though. I hear you don’t 
take well to change. 

Store： I don’t think you’re getting the whole picture. 
See, it’s my job to make sure your data is loaded and 
saved exactly right. 

Head First： I get that, but still, small changes are 
OK, right? 

Store： Sure 一 I just need to make sure you really 
want me to do them. You need to tell me what 
data I’m looking at and then tell me how you want 
me to return it to you. Tell me it’s OK to infer the 
differences and do the mapping and I’ll take care of 
the rest. 

Head First： So do you actually migrate the data or 
just translate it when you load it? 


Store： Oh, I actually migrate the data. Now, here’s 
where things get cool. Simple stores like the binary 
file ones just create a new file with the migrated data. 
But if I’m using a SQLite DB, I can usually do the 
migration right in place. Don’t need to load the data 
and the whole migration is nearly instant. 

Head First： Nice! I thought lightweight migration 
was kind of a noob’s migration. 

Store: Oh no, if you can let me do the migration 
through lightweight migration, that’s definitely the 
way to go. Now if you need to do something more 
complicated, like splitting an old attribute into two 
new ones or change the type of something, you’ll 
need to help me out. 

Head First： And people do that through code? 

Store： Sort of. Basically, you need to give me one 
more model, a mapping model. That tells me how 
to move your data from the old format to the new 
format. 

Head First： Hmm, OK, makes sense. I guess this 
applies to renaming variables too? 

Store： Actually, most of the time I can handle that 
too, as long as you tell me what the old name was. If 
you look at the details of an attribute in your object 
model, you can give me the old name of an attribute. 
If it’s there, and I have to do a migration, I can 
handle renaming too. 

Head First： Wow, you’re not nearly as boring as I 
thought... 

Store： Thanks, I guess. 
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no dumb migration questions 


tJiereiare no ^ 

Dumb Questi9ns 


How may versions of a data model 
can I have? 

As many as you need. Once you start 
adding versions, you’ll need to keep track 
of your current version so that Managed 
Object Model knows what you want when 
you ask for an entity. By keeping all of the 
old versions around, Core Data can migrate 
from any prior version to the current one. 

When is renaming something OK 
for a lightweight migration? When isn’t it? 

You can rename variables as long 
as you don’t change the type. If you 
rename them, click on the little wrench 
on the attribute properties in Xcode and 
specify the renaming identifier to be the old 
attribute. Core Data will handle the migration 
automatically from there. 

Can I use migration to get data 
I have in some other format into Core 
Data? 

No. Migration (lightweight or 
otherwise) only works with existing Core 


Data. If you have legacy data you want 
moved into Core Data, you’ll need to do 
that yourself. Typically, you just read the 
legacy data with your own code, create a 
new NSManagedObject to hold it, populate 
the new object, and save it using Core 
Data. It’s not pretty, but it works. There are 
a couple other approaches you can look 
at if you have large amounts of data to 
migrate or streaming data (for example, from 
a network feed). Take a look at the Apple 
Documentation on Efficiently Importing Data 
with Core Data for more details. 

oes it make a difference if I use 
lightweight migration or migrate data 
myself? 

Use lightweight migration if you can. 

It won't work for all cases, but, if it can be 
done, Core Data can optimize the migration 
if you’re using a SQLite store. Migration 
time can be really, really small when done 
through lightweight migration. 

What do I do if I can’t use 
lightweight migration? 

You'll need to create a mapping model. 
You can do that in Xcode by selecting 


Design^Mapping Model, then picking 
the two models you want to map between. 
You’ll need to select your source entities 
and attributes, then select the destination 
entities and attributes. You can enter custom 
expressions to do data conversions if you 
need to. To find out more information on 
mapping models, check out the Apple 
Documentation on Core Data Migration. 

Xcode lets me enter a hash 
modifier in the Versioning Settings for an 
attribute. What are those for? 

Core Data computes a hash for 
entities using attribute information so it can 
determine if the model has changed since 
the data store was created. However, it's 
possible that you need to change the way 
your data is stored without actually changing 
the data model. For example, let’s say you 
always stored your time values in seconds, 
but then decided you needed to store 
milliseconds instead. You can continue to 
store the value as an integer but use the 
version hash modifier to let Core Data know 
that you want two models to be considered 
different versions and apply your migration 
code at runtime. 



^-^BUllET POINTS —— 

■ Lightweight automatic migration 
needs both versions of the data 
model before it will work. 

■ Automatic migration can change a 
SQLite database without loading the 
data. 


■ Migration of data happens at 

runtime. 

■ You can use lightweight migration 
to add variables, make a required 
variable optional, make an optional 
one required with default, and to do 
some renaming. 
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migrating and optimizing with core data 



- pill m -tKc date . 
time o-f tapWc da-ta ； 

pis^laY o^Y . 

-fujitivcs m 
i\\t da\>Wcd vioN. 


-fco -fujitivcs. 

、处 i % tayWed 

-tirwC^C^jr "tKc •fu^i'tiyc 

- Add tKc 
d 3 "tc fe\r 







What kind of changes do we need to make 
to the UI to add the capture information? 
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bob should keep his day job 


fob has some design input 


I want all of this captured info on 
the detail view. Here, I sketched 
up some ideas. 



O 


I was thinking 
I could just type in y 
or N when I capture a 
guy? Then fill in the date 
and time below. 


■ - - - 2 ----1 


Cancel 


Save 


Fugitive Carrie 

(FugitTVV ID# 


Lorem [psum dolQi 1 er elii 
lamet, consectetaur ciflium 
adipisicing pecu F $ed do 
elusmod lempor IncldldurtL ut 
tabore dolore magna 
allqua. Lit enJm fld minim 
vnniJirn, qul^ rwstrud 


Bounty: $1 h 000 p 000 


Capture 


Date & Time 


But Bob’s sketek 
kas some problems •“ 
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migrating and optimizing with core data 


r ^harpen your pencil 


i Bob’s view needs some improving. As an experienced 

iPhone developer, you can probably come up with 
some better Ul designs. Time for you to help him out. 

o Gan Bob’s view actually work with the app as it’s currently written? (Circle one) 


Yes 


No 


❺ If not, why not? 

o To properly implement this view, you need to know what data is editable. What 
data can the user edit and what is the best way to handle that input? 

❺ Sketch up your plan for the final detail view: 


po^-t afeou-t 

i\\t -tab kav toy>*tvollcv 


FugiiEUvg iNAma 

FuathU IDi 

Larflm ip^um dpln? m eli| 

larnsl, 阳 Allium 

^dipigicing pflcu, serf rin 

henipor Inddldunft uf 
Labors m dolore miignD 
Ult 兮 mim Ad nfiinim 
v&ni.im, quls noslmrt 


Bounty. $1 
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a better interface 


r ^^arpen your pencil 

Solution 


Now that you’ve thought through the design implications, 
what should the detail view look like? 


o 

❺ 


Gan Bob’s view actually work as is with the app as written? (Circle one) Yes 

If not, why not? Wt. j 5 |l.v ： cady. bayc a. u badk w , buiioh.vyhcy：?. Bob wa.^is pui.a 
/\skm^ 七 user ip rnfut theoy w f/ w dhd type *th?. da*tc By\d tiry»e. is ^o-t a. U.l ； 



o To properly implement this view, you need to know what data is editable. 

What data can the user edit and what is the best way to handle input? The ohly datcl to. 

is *thc captured ^icld dhdi -the daptuyed date *tir«c. Smdc daptuy'cdi is a boolean 
d svyi-t^h ?)T ?•???• jf,°"f ^oh*t)rol y/ill vyork Jf)C't*tcy- Sihdc Bob y/ill hi*t *thc dor\*t^ol whch ItiC 

captures the bad guy, v/c dah just yt -the duryeh-t date a^d -from iPhone a^d save cyc^ more typmj. 



Sketch up your plan for the final detail view: 





lA/c 於 《d *tWis 

la 七 cv — well ^avc 
七 o sec …. 


Fugitive Mama 


TVsc *Uo fields Will 
fee labels, l»kc locW. 


Po^t alooJ 
i\\t *tafe feav toy>*tvollcv 

dovm hcvc. 


ruEi^ri] ioi 


Uirflm 中 sum ckjlpr 
lam^L, allium 

eciipisicin^ pecu. 

iflmpqr irvdcjidunrL ul 
IfltxirQ! pA dqlqna- mpgnii 
nliqua Ur 杉 fiim 細 mmim 
v^niArTi. quie rtQ^rud 


Bnunty ： 51 .DOO.tKlO 


Ym 


Da*tc, -time, 

ih-fo iC 


A segrwe^-ted dojvbrol will work 
jv-cat hc^rc- Thai will 你 … 

NO iypmj \rc^uiv-cd -to mpui 

七 he data. 


Label v/ ••七 h da*tc f tiw\c m-fo- 
populated by *thc -fvom 
y/hc^ the yes/ y\o is -tolled- 


M - 


View 




Fy^Jdvsc 
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migrating and optimizing with core data 



Make the additions you need to the detail view 
to include the additional fields. 



Open up FugitiveDetailViewController.xib in Interface 
Builder. 

Go ahead and add the visual elements you need: the three labels, and 
the segmented control. You’ll need to add a simulated tab bar to make 
sure that everything will fit. Don’t worry about the save button for now. 



In FugitiveDetailViewController.m (and .h) # add properties 
and initialization code. 

Now that all of those interface elements exist, give them the back end in 
Xcode, but don’t worry about linking them just yet... 
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exercise solution 



E^eRciSe 

SoLuiiOH 


Here are the additions to the view, 
and the code to support them. 


o Open up FugitiveDetailViewController.xib in Interface Builder. 



Fugilivp rirurnn 

w elil 

\ianot, QQn$ 4 el;c 1 aiur cilliijmi 
a^qiisicuig p 9 W. wd dn 
wusmcd Latnpor incididtutil ul 
labors el datefe magrva 
d^quB. Ut efiim ad mtnirrv 
v^niam, quis rv^Jrud 


Bounty, in , 000.000 
Capttifod? No 

Cvturp A Time 



^> 99 lc this sclc^tioh 
*to jet -to the othev- 

h^l-r of the doh*t\rol. 

、 

TV^ SC^W'C^'tcd to\r\*tv*ol 
y\ccds b> be ed 

(i 七 says -f iv-s*t/ stCov\A 

by drfauH:). 




- I < 






Mlfli 

flyjn 


: i 


i 


U^pntnEij^v 




^ri|rmi 1 0 





Vw% 


~ ■ 0 V 

JCOWifl 

r4 UuDUd 1^ 圳伽 




Onjfa'u Ktd } 



① 1 


This is the label that will hold the 

uptuad daic a^d time, but its empty 

Uhl«s swi^h is boggled io yes. L 


Make suve w Sc^mcr>*t O - Ycs w 

IS selected dv>d \>oi\\ sc^rnc^ts 

avc enabled- WtW r\tt& *this m d 


❺ In FugitiveDetailViewController.m (and .h) # add properties 
and initialization code. 



UlSegmentedControl *capturedToggle; 
UILabel *capturedDateLabel; 


hdd *this ihsidc 
"the 敌 hte\r*Pa 乙 e. 



hdd this with 

"the o-thev- & 
P'ropcirtics. 


©property (nonatomic, retain) 
*capturedToggle; 

©property (nonatomic, retain) 
*capturedDateLabel; 


IBOutlet UlSegmentedControl 

~ ^ 


IBOutlet UILabel 



FugitiveDetailViewController. h 
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migrating and optimizing with core data 


Qsynthesize fugitive, fugitiveNameLabel, fugitiveldLabel, 
fugitiveDescriptionView, fugitiveBountyLabel, capturedDateLabel, 
capturedToggle; 


FugitiveDetailViewController.m 


- (void) viewWillAppear : (BOOL)animated { 
[super viewWillAppear:animated]; 


fugitiveNameLabel.text = fugitive.name; 

fugitiveldLabel•text = [fugitive•fugitivelD stringValue]; 
fugitiveDescriptionView.text = fugitive.desc; 
fugitiveBountyLabel.text = [fugitive.bounty stringValue]; 

capturedDateLabel.text = [fugitive.captdate description]; 

capturedToggle.selectedSegmentlndex = [fugitive.captured 
boolValue] ? 0 : 1; 


Cohvcirt -the daic 
■to a label ihc 
dcs^v-ip-tioh. 


Set "tiic bdsed oy \ whethev* "they 

a 代 ^apiuv-cd- 0 — /ES, / — tJO- 


- (void)dealloc { 

[fugitive release]; 

[fugitiveNameLabel release]; 
[fugitiveldLabel release]; 

[fugitiveDescriptionView release]; 

[fugitiveBountyLabel release]; 

[capturedDateLabel release]; 

[capturedToggle release]; _ 

[super dealloc]; 


Tqst DriVQ 


FugitiveDetailViewController.m 


Build and debug to make 
sure the interface is working. 
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test drive 




Tqst DriVQ 



atl S PM 




Low 嗶 




Car IfHEifl ma 改 i#g 


COSSflSSrfMl 


Pountji ： Z2W0 

VOE f 

flp 

taptu— pfli? fli 


All tke view 
elements look good! 
Now we just neect 
to implement tkeir 
tekaviors... 


ihere^e nQ ^ 

Dumb Questi9ns 


Why didn’t we use the switch instead of 
the segmented control? 

Because there’s no Apple-sanctioned way 
to change the text of the switch. By default, the 
options are On and Off, which won’t work for us. 

Why didn’t we use a check box for the 
captured field? 


It turns out that the check box isn’t a 
standard control. It's certainly surprising, since you 
see them so often in iPhone apps. 

They can be done, however, by creating a custom 
button with three images (an empty box, a 
selected box, and a checked box), and switching 
between them. 
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Toggle Code Magnets 

Now that we have the controls laid out the way we want 
them, we need to actually give them some behavior. Use the 
magnets below to implement the method that will handle the 
segmented control switching. Then everything will be ready 
for linking to the segmented control in Interface Builder. 


-( 工 BAction) capturedToggleChanged : (id) sender 


if 


~k 


now = [NSDate 


now; 


fugitive.captured = [NSNumber numberWithBool : YES] 


else 


二 nil 


fugitive.captured = [NSNumber numberWithBool : NO] 


capturedDateLabel.text 
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toggle code magnets solution 


Toggle Code Magnets Solution 




Now that we have the controls laid out the way we want 
them, we need to actually give them some behavior. Use the 
magnets below to implement the method that will handle the 
segmented control switching. Then everything will be ready for 
linking to the segmented control in Interface Builder. 

This will ohly be called 
七 k value actually dhdhjed, 

so "the selected ihdex is 

( 工 BAction) capturedToggleChanged : (id) sender how O, the -fugitive 

_ ^ptu\rcd pHov- -to this tall 



Oh 


OUh 


6o ^ol 


Yes 


if ( 


capturedToggle.selectedSegmentlndex 

[NSDate I date]; 


0 ) 


NSDate 


■k 


now 


fugitive.captdate J 

fugitive.captured 


else 


fugitive.captdate 

fugitive.captured 


TW»s Will \rcW^ ^ N^Pa-bc sc-t -to 
七 da-tc a^d 

[NSNumber numberWithBool: YES ] ；/. 

Core Pa*ta boolean as j 

(s/SKumfecvs, so v/c *to 
ouv boolean VK/NO values 
KSKumkcvs bo U?da 七 c 払 c 


nil; 

[NSNumber 


numberWithBool : NO] 


l-f *tKc -fugitive is^*t daf*tu\rcd, dlcav *thc 
old daftuve da*tc *»-(* *tV>cv-c was o^c- 


capturedDateLabel.text 




Da this! 


TVis will \rctu\rh a text 一 
^rcfvcsch-btioh o( ah MSDaic. 





Add the code above to 

FugtiveDetailViewGontroller.m and don’t forget 
the corresponding declaration in the .h file: 

-( 工 BAction) capturedToggleChanged : 
(id) sender; 


Finally, link the capturedToggle 
outlet for the segmented control to File’s 
Owner in Interface Builder and link the 
value changed event from the segmented 
control to the capturedToggleChanged 
action in the Files’s Owner. 
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TesT DriVq 


Now that all of that work is done, you should have a 
functioning detail view. Give it a try … 


TV>c v*«cy/ looks yca*t ay>d 

to^ol \s set No, 

jus*t like rt Should be. 



|-f you -bo^lc 
sc^c^tcd 6orrbrol, 
i\st date ay^d 
av-c -f illed »v>- 



It’s working! Spend some time moving around in and out of 
the table view, mark a fugitive as captured, and then come 
back into that same fugitive. Go ahead, quit the app and 
check again, we dare you. What’s going on? 
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saving with managed object context 



O 


Wait a minute. The data is still there if I go 
back to the table view—ifs even still there if 
I completely exit the app and come back in the 
simulator. It*s saved? How did that happen? 


Core Data handles saving ， too! 

Checking that Gore Data box when you created 
the app did more for you than you realized — it 
enabled saving as well. 


The Managed Object Context saves new or changed items 

We’ve used the managed object context to load our Fugitives, but it is also responsible 
for coordinating saving your data, too. Remember how NSManagedObject can keep 
track of changes to entities? The Managed Object Context can take advantage of this 
information to tell if you if there are any changes in the objects it’s managing. Similarly, 
if you create a new instance of an NSManagedObject, you need to tell it which 
Managed Object Context it belongs to and that Managed Object Context knows it has 
new entities to keep track of. The Gore Data template takes advantage of this during 
application exit to see if the Managed Object Context has any new or changed data. If 
it does, the application simply asks the context to save them. 


TWis toAt 

• IS dV.cdkmoy U as 70 U 

七从 c a 代 . V 

- ^ 


- (void)applicationWillTerminate:(UIApplication *) 
application { 


NSError *error = nil; 
if (managedObj ectContext 


nil) { 


if ([managedObjectContext hasChanges] && 
! [managedObj ectContext save : &error]) 
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You said if I create new instances 
of NSManagedObjects I need to tell them 
which Managed Object Context they 
belong to. How do I do that? 

It’s part of the EntityDescription we 
mentioned in Chapter 7. If you want to create 
a new instance of an NSManagedObject, 
you just do this: [NSEntityDescription inse 
rtNewObjectForEntityForName:@”Fugitive” 
inManagedObjectContext:managedObject 
Context];. The Managed Object Context is 
provided right from the start. 

What’s the “&error” that’s being 
passed to the save call? 

Most Core Data load/save operations 
point to an NSError in case something goes 
wrong. The in Objective-C behaves 
just like it does in C or C++ and returns the 
“address of’ the item. We declare a pointer 
to an NSError then pass the address of 
that pointer into the save method in case 
something happens. If the save call fails, 
Core Data will populate that error argument 
with more detailed information. 

Speaking of errors, what should I 
do if this comes back with an error? 



That’s really application-specific. 
Depending on when you detect the problem, 
you can warn the user and try to recover; 
other times there’s not too much you can 
do. For example, if the error happens during 
the applicationWillTerminate method, there's 
not much you can do other than tell the user 
the save failed and possibly stash the data 
somewhere else. 

Should I only ever call save in 
applicationWillTerminate? 

No, not at all. The Core Data template 
set it up this way for convenience, but you 
should save whenever it's appropriate in 
your application. In fact, if you’re using a 
SQLite database backend for your data, 
saves are significantly faster than when we 
were working with plists in DrinkMixer. You 
should consider saving additions or changes 
to the data as soon as possible after they 
are made to try and avoid any kind of data 
loss. 

You said Core Data could do data 
validation; where does that fit into all of 
this? 

At a minimum, Core Data will 
validate objects before they’re stored in the 


Persistent Store. So, it’s possible that you 
could get a validation error when you try to 
save your changes if you have invalid data 
in one of your managed objects. To avoid 
such late notice, you should validate your 
NSManagedObjects as close to the time 
of change as possible. You can explicitly 
validate a new NSManagedObject like this: 
[fugitive validateForlnsert:&error]. Similarly, 
there are methods for validating updates and 
deletes. You can call these methods at any 
time to verify that the NSManagedObject is 
valid against constraints you put in the data 
model. If it's not, you can notify the user and 
ask them to correct the problem. 

What if I don’t want to save the 
changes in the Managed Object Context? 
Can I reset it? 

It’s easier than that—just send it 
the rollback ： message. When a 
Managed Object Context is told to rollback 
it will discard any newly inserted objects, 
any deletions, and any unsaved changes 
to existing objects. You can think of the 
Managed Object Context as managing 
transactions—changes to entities, including 
insertion and deletions, are either committed 
with a save : message or abandoned 
with a rollback : message. 
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bob^ demo 


A quick demo with fob 

After seeing the detailed view and all the captured stuff, 
Bob’s thrilled, but has one quick comment: 



After all that, we 
forgot to populate the 
captured list! 
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OK, I know how to populate the table cells and 
stuff—but how can I only pick captured guys? 


We can use Core Data to 
filter our results. 

We already have capture information in 
our Fugitive data; we just need to use it 
to get the captured list. We need a way 
to tell Gore Data we only want Fugitives 
where the captured flag is true. 


Wliere is a natural place to put 
tkis kind of filtering? 
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predicates in Xcode 


Use predicates for filtering 
data 


In database languages all over the world, predicates are 
used to scope a search to only find data that matches 
certain criteria. Remember the NSFetchRequest we 
talked about in Chapter 7? We’ve used the Entity 
Information and Sort Descriptor but haven’t needed 
the predicate support... until now. 


NSFetchRequest 








us. 



NSFetchRequcst concepts arc nearly 
identical to SQL 


The three major concepts in an NSFetchRequest are 
nearly identical to the expressions in standard SQL: 


Ewtity Iwfo 




Predicate 



S 夕 L is a la 呼 ay 
used -fov 
di3"t3 ^^ scs， 


descriptor 


E 灼七》切 |r\-fo\rma*tior\ *tclU Core , 
Pa*ta *tV^c type o-P data wc 
-fov- (and back). 

f*OV" \AS, *tW»s IS d Fugitive c\bss. 


、 ， 

Wtrts tVic ^\tct v/c v^avc^t used 

bcW. TVic ^cdidatc ㈣ Wes 

do^d'it'io^s data must 

|.f *i*t doesn't rb docsy\ *t 

V*C*tiA\nr\cdi V*csul*ts- 


used Sort 
■to order data 
al^abctitally m h\c results. 



SELECT * FROM tuGIT^^S WHERE {captured 


ou\r 


This is s“ ^ _ / 

ih4.. Hoi exactly 
the sar^c, but dose. 


“’s ihc S 夕 L 



All we need to do is provide the predicate information 
to our NSFetchRequest and Gore Data handles the 
rest. We can use an NSPredicate for that... 
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We need to set a predicate on our NSFetchRcquest 

NSPredicate is a deceptively simple class that lets us express logical constraints on our NSFetchRequest. 
You use entity and attribute names along with comparison operators to express your constraint information. 
You can create a basic NSPredicate with a string format syntax similar to NS String, like this: 

NSPredicate ^predicate = [NSPredicate predicateWithFormat : Q^captured == YES’’]; 
[request setPredicate:predicate]; 

But NSPredicates don’t stop with simple attribute comparisons. Apple provides several subclasses like 
NSComparisonPredicate, NSCompoundPredicate, and NSExpression as well as a complex 
grammar for wildcard matching, object graph traversal, and more. For iBountyHunter, a simple attribute 
condition is all we need to get Bob’s view working. 



Time to populate the captured view! There’s some work 
to get the captured view updated to where the fugitive 
view is, and then a tweak to display what we need. 



Set some captured fugitives. 

Build and run the old version of the app and toggle a 
handful of the fugitives to captured before making any 
changes. You’ll need that for testing. 



Get the captured view to match the fugitive view. 

Where we left off in Chapter 7, we hadn’t yet done the work to 
populate the captured list. Since we’re just going to be filtering 
the data that’s in the fugitive list, the easiest way is to start with 
the entire list and then add the filtering code. Don’t forget the 
tableview datasource and delegate methods. 



Add the predicate code. 

Update your NSFetchRequest to use an NSPredicate so 
it only finds captured fugitives. This needs to go into the 
viewWillAppear method in the GapturedViewGontroller.m. 
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updating the captured view 


BtGRciSe 
SoLuitOH 


You should recognize the code from Chapter 7 to get the captured 
view working, and then the predicate code to get the filtered data. 


o 

❺ 


Set some captured fugitives . 獻 


Y^u handle -this oy\c — d^y 
弓 iha-t you 


Update the captured view to match the fugitive view. 


Qinterface CapturedListViewController : UITableViewController 

NSMutableArray *iterns; 


©property (nonatomic, retain) NSMutableArray *iterns; 


@end 



CapturedListViewController.h 


#import ''CapturedListViewController. h" 

#import ''iBountyHunterAppDelegate. h 〃 

#import ''Fugitive .h 〃 

#import ''FugitiveDetailViewController. h y 

@implementation CapturedListViewController 

@synthesize items; 


CapturedListViewController.m 
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- (void)viewWillAppear : (BOOL) animated { 

[super viewWillAppear : animated]; 

iBountyHunterAppDelegate *appDelegate = (iBountyHunterAppDelegate*) 
[[UIApplication sharedApplication] delegate]; 

NSManagedObj ectContext *managedObjectContext = appDelegate. 
managedObjectContext; 

NSFetchRequest *request = [[NSFetchRequest alloc] init]; 

NSEntityDescription *entity = [NSEntityDescription 
entityForName : @ ’’Fugitive” inManagedOb j ectContext : managedObj ectContext]; 

[request setEntity:entity]; 

NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] 
initWithKey : @"name" ascending:YES]; 

NSArray *sortDescriptors = [[NSArray alloc] 
initWithObjects : sortDescriptor, nil]; 

[request setSortDescriptors : sortDescriptors] 

[sortDescriptors release]; 

[sortDescriptor release]; 


This dodc is exactly 

"the sar^c Code that 
we used -Pov the 

Fu0i'tivcL.is't\/icy/Coh't\rollcv". 


NSError *error; 

NSMutableArray *mutableFetchResuits = [[managedObjectContext 
executeFetchRequest : request error : &error] mutableCopy]; 

if (mutableFetchResuits == nil) { 

// Handle the error. 


self.items = mutableFetchResults; 
[mutableFetchResults release]; 
[request release]; 


CapturedListViewController.m 
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E^eRciSe 

S°ty^°rt 


You should recognize the code from Chapter 7 to get the captured 
view working, and then the predicate code to get the filtered data. 

❻ Get the captured view to match the fugitive view (continued). 


#pragma mark Table view methods 

- (NSInteger) numberOfSectionsInTableView: (UITableView *) tableView { 
return 1; 

} 

// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NS 
Integer)section { 

return [items count]; 

} 

// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndex 
Path:(NSIndexPath *)indexPath { 

static NSString *CellIdentifier = @ 〃 Cell 〃； 

UITableViewCell *cell = [tableView dequeueReusableCellWithldentifie 
r:Cellldentifier]; 

if (cell == nil) { 

cell = [[[UITableViewCell alloc] initWithStyle : UITableViewCellStyle 
Default reuseldentifier : Cellldentifier] autorelease]; 


// Set up the cell... 

Fugitive *fugitive = [items objectAtlndex : indexPath.row]; 
cell.textLabel.text = fugitive.name; 
return cell; 




CapturedListViewController.m 
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- (void) tableView : (UITableView*) tableView didSelectRowAtlndexPath : (NSI 
ndexPath *)indexPath { 

FugitiveDetailViewController *fugitiveDetailViewController = 

[[FugitiveDetailViewController alloc] initWithNibName:@〃FugitiveDetail 
ViewController 〃 bundle:nil]; 

fugitiveDetailViewController.fugitive = [self.items 
objectAtlndex : indexPath.row]; 

[self.navigationController pushViewController : fugitiveDetailVie 
wController animated:YES]; 

[fugitiveDetailViewController release]; 


- (void)dealloc 


[items release] 

[super dealloc]; 


CapturedListViewController.m 


Add the predicate code. 



NSPredicate *predicate 
YES"]; 


[NSPredicate predicateWithFormat : @"captured 




[request setPredicate:predicate]; 


Put tWis m vicwlA/illAppcar just after 
[request setEntity:entity]’• 



CapturedListViewController.m 



TesT DriVq 


Go ahead and fire it up—the captured 
view should be ready to go! 
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test drive 



TesT DriVq 



• i.CairiKf 


a m pm 


EmmanuEl Uttcnburg 


Fiona Westm 


George Pafln 
Henry^ Lewis 


2A2 PM 


Oafriure l>aj^ & Tim ^； ia^ai -friifl 


SlcaJing cool names 睡 ram 
erther Industries. 


Sounly: 23000 


It works! Tkese are tke four 
fugitives we markect as captured. 
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Hang on—you said we should be careful with 
memory and performance and blah blah... Now we 
have two arrays of fugitives and we reload them 
every time the view appears. It seems pretty 
dumb. What if we moved this code to viewDidLoad 
so ifs only done once per view? 


True, we can make this a lot more 
efficient. 

But not by moving it to viewDidLoad. If we move the 
code there, we’re going to end up with two new problems. 
We need another solution... 


What problems would we introduce if we moved 
the fetching code to viewDidLoad? What else 
could we do to improve performance? 
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results handling 


Core Pata controller classes provide efficient 
results handling 

The code for both the FugitiveListViewController and the 
CapturedListViewController is in viewWi 11 Appear. The problem is 
that viewWi 11 Appear gets called every time the view is shown, which means 
we’re reloading all of the fugitives and all of the captured fugitives every time, 
regardless of whether anything’s changed. 


We could move the code to viewDidLoad, but that only gets called when the 
views are loaded from their nibs. That causes two problems. First, if we mark 
a fugitive as captured, the Captured List won’t reflect that since it only loads 
its data once. The second problem is that viewDidLoad gets called before our 
applicationDidFinishLaunching, which means the views will try to get 
their data before the app delegate gets a chance to copy the master database in 
place. What we need is a better way to manage our fetched data. 



Plaru Wallin 
Pwim 
Honry Lfms 



Table views and NSFctchedResultsCoMtrollers 
arc made for each other 

Since UITableViews are such a common component 
and frequently deal with large amounts of data, there’s 
a special Gore Data class designed to support them. The 
NSFetchedResultsGontroller works together with the 
Managed Object Context and your NSFetchRequest to give 
you some pretty impressive abilities: 

Very efficient memory usage 

The NSFetchedResultsGontroller works with the NSFetchRequest and 
the ManagedObjectModel to minimize how much data is actually in 
memory. For example, even if we have 10,000 fugitives to deal with, 
the NSFetchedResultsGontroller will try to keep only the ones the 
UITable View needs to display in memory, probably closer to 10 or 15. 

High performance UITableView support 

UITable View needs to know how many sections there are, how many rows 
there are in each section, etc. N SFetchedResultsG ontroller has built-in 
support for figuring that information out quickly, without needing to load 
all of the data. 

Built-in monitoring for data changes 

We’ve already talked about how the Managed Object Context knows 
when data is modified. NSFetchedResultsGontroller can take advantage of 
that to let you (well, its delegate) know when data that matches your fetch 
results is modified. 
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Time for some high-efficiewcy streamlining 


We need to do a little refactoring to get NSFetchedResultsGontroller 
in there, but when it’s done, Bob could give us a database of 100,000 
fugitives and iBountyHunter wouldn’t blink. We’re going to do this for the 
CapturedListViewController, but the same refactoring will apply to the 
FugitiveListViewController too. 

First, we need to replace our items array with an instance of an 
NSFetchedResultsController, like this: 


do^tv-ollcv- *to tell us 
^ data - 

v/c bo to 


Qinterface CapturedListViewController : UITableViewController 

<NSFetchedResultsControllerDelegate> { ^ - 


NSFetchedResultsController *resultsController 


Qproperty (nonatomic, retain) NSFetchedResultsController 
*resultsController 


@end 


Remove •.tems away a^d ^ 
政 wd 七 ksc a” 



CapturedListViewController.h 


@implementation CapturedListViewController 

@synthesize resultsController; 



- 

- (void)dealloc { 

[resultsController release]; 

[super dealloc]; 

} 

@end 


Delete the "fco the 

items 3\r\ray 3hd \rdc3sc 
the hCW View dohtv-ollcv-. 



CapturedListViewController.m 


Next we weed to change the 
search to use the controller. 
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use the controller 


Refactor viewWillAppear to use the controller 



- (void) viewWillAppear : (BOOL)animated 
[super viewWillAppear : animated] 

if (self.resultsController ! 
return; 


nil) 


滅23& (一 


iBountyHunterAppDelegate ^appDelegate = (iBountyHunterAppDelegate*) 

[[UIApplication sharedApplication] delegate]; 

NSManagedObj ectContext *managedObjectContext = appDelegate. 
managedObjectContext; 

NSFetchRequest ^request = [[NSFetchRequest alloc] init]; 

NSEntityDescription ^entity = [NSEntityDescription entityForName : Q^Fugitive' 
inManagedObjectContext : managedObjectContext]; 

[request setEntity:entity]; 


YES"]; 


NSPredicate ^predicate = [NSPredicate predicateWithFormat : Q^captured 
[request setPredicate:predicate]; 


v. 


NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] 
initWithKey : @ 〃 name 〃 ascending:YES]; 

NSArray *sortDescriptors = [[NSArray alloc] initWithObjects:sortDescriptor, 

nil]; 

[request setSortDescriptors : sortDescriptors]; , . ^ 

[sortDescriptors release]; !, ouv 

[sortDescriptor release]; 

NSFetchedResultsController *fetchedResultsController = 

[[NSFetchedResultsController alloc] initWithFetchRequest : request 

managedObjectContext : managedObjectContext sectionNameKeyPath : nil 
cacheName: @"captured_list • cache"] ; ., 七 delegate so 

fetchedResultsController.delegate = self; , da*ta 

NSError *error; ^ —从代 

BOOL success = [fetchedResultsController performFetch:&error]; 

if (! success) { mstcad o-f askmj 

// Handle the error. Object Model -to 

} 从 ask 如 ^o^ollcr. Tud the 仏士 oil 饮 

self. resultsController = fetchedResultsController^; 

[request release] ; ^ ^ data out. 

[self. tableView reloadData] ; Till the -table view ouv 

— has 
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Hmm, so if we get rid of the array 
of Fugitives, then were going to have to 
reimplement the datasource and delegate 
methods too, right? My guess is were going 
to use the NSFetchedResultsController 
there as well? 


Yes- 

The NSFetchedResultsController gives us everything we 
need to access the fetched data. In fact, it can do it a lot 
more efficiently. 


«^harp€n your pencil 


We’ve given you the code to set up the 
NSFetchedResultsController. Now you need to 
update the tableview delegate and datasource 
methods to use the controller instead of the view. 



Refactor numberOf SectionsInT able View and 
numberOfRowsInSection to use the controller. 

NSFetchedResultsController has a sections property 
that is an array of NSFetchedResultsSectionlnf o 
objects. Use those to figure out how many sections there are and 
how many rows in each section. 



Refactor ce 11 For Ro w A tlndexPat h and 
didSelectRowAtlndexPath to use the controller. 

NSFetchedResultsController makes it easy to 
implement these methods using its objectAtlndexPath method. 
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^harp your pencil 

Solution 


Here is the final code for CapturedListViewController.m 
table methods. 


^pragma mark Table view methods 

- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView { 

return [ [self. resultsController sections] count] ; ^\ 

} number scdtio^s wc cav\ just rti\AYv\ 


i\\t settlors m i\\t dorrbroller. 


// Customize the number of rows in the table view. 

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger) 
section { 

return [[[self.resultsController sections] objectAtlndex : section] 
numberOfObjects] ; f u j 一 — us_ 釙 J tU: 


You tould V^avc also Aov\t usmj av\ id t^at 
U KSFc^caRcsultsS^t.or.1^0 ^ot>dol. 


// Customize the appearance of table view cells. 

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtlndexPath:(NS 
工 ndexPath *) indexPath { 

static NSString *CellIdentifier = @”Cell 〃； 

UITableViewCell *cell = [tableView dequeueReusableCellWithldentifier:Celllden 
tifier]; 

if (cell —— nil) { 

cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault 
reuseldentifier:Cellldentifier] autorelease]; 


// Set up the cell... 


Fugitive *fugitive = [self.resultsController 
objectAtlndexPath:indexPath]; 

cell.textLabel.text = fugitive.name; 

return cell; here - jus*t jc*t 


r 

1 


Fugitive a*t mde%Pa*tiv 


^~- -- 


CapturedListViewController.m 
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- (void)tableView:(UITableView*)tableView didSelectRowAtlndexPath:(NSIndexPath *) 
indexPath { 


FugitiveDetailViewController ^fugitiveDetailViewController = 

[[FugitiveDetailViewController alloc] initWithNibName : Q^FugitiveDetailViewControl 
ler” bundle : nil]; . , 

more lookup \o>c ^dc^Path to 

yt the Fujitwc, a^d y/cVc all set 




fugitiveDetailViewController.fugitive = [self.resultsController 
objectAtlndexPath:indexPath]; 


[self.navigationController pushViewController : fugitiveDetailViewControlle 
r animated:YES]; 


[fugitiveDetailViewController release]; 


1 





LJ 


CapturedListViewController.m 




Tesr DriVq 


Go ahead and run iBountyHunter to make sure the changes didn’t break 
anything. The views should be loading just like they were... sort of. Do some 
quick testing—if you mark a fugitive as captured, does he switch lists? What if 
you exit and come back into the app using the home key? 
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test drive 



Tesr DriVq 


Now that you’re using the controller instead of just a predicate, the 
behavior of the app should be the same. But people are showing up 
in the captured list even when they’re not marked as captured! 





a- i pm 


Emmanuel UltiMibur^ 


Fiona mstfin 
George Palin 


Hanrv 





Why aren’t fugitives properly changing lists 
when you change their captured status? 
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migrating and optimizing with core data 


We need to refresh the data 


The fugitives aren’t properly changing lists when you change 
their status because we’re not refreshing the data every time 
the captured list view is displayed. We need to set up the 
NSFetchedResultsGontroller to let us know when things have 
changed so we can update the table. 

- (void)controllerDidChangeContent : (NSFetchedResultsController *)controller 



[self.tableView reloa 

Tiic -table v*ic>w >will tomplc*tcly v-cload 
-the y/hcir> i*t dc*tc£.*ts d 


NSFetchedResultsController caw check for changes 


Now that we’ve set up the app to work with the NSFetchedResultsController 
instead of just an array, we can leverage the methods embedded with the 
controller to help us. The view controller has built-in support for monitoring 
the data for changes through a delegate. We had set ourselves up as that 
delegate but never implemented the code to handle data changing. 

Having the view completely reload when it detects a change can become 
cumbersome if you are dealing with a large amount of data; however, the 
FetchedResultsG ontroller delegate also has support built-in for notifying 
you of the specific cell that is changed, and you can modify just that. Check 
Apple’s documentation for more details. 



Implement the controllerDidChangeContent 
method that we listed above, and make sure 
everything’s working. 
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test drive 




TesT DriVq 


Do the same thing you did last time, build and run, and 
then change the status of one of the fugitives to pull 
him dynamically out of the captured list. 





Emmanuiil UTlcirtburg 
Fiona WvtEEll 
Hunler Srt 桃 

Martin 


St^v -七 with ^ daptuircd 
•fugitives... 


...vcmovc oy>c 


-firom "tKc lis 七 … 


"•and he’s *immcd*ia*tcly 50^ 
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migrating and optimizing with core data 


This is awesome! The advantage I*m going 
to have over the competition is great, and 
having all that information with me means 
that ril be making way fewer trips back to 
the police station. Thanks! 


There’s nothing like a 
satisfied customer! 
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no dumb questions 


Where can I find the full syntax for 
NSPredicate? 

NSPredicate has a pretty complex 
syntax available for expressing constraints 
on your data. There's a simple summary 
available in the NSPredicate class 
documentation but Apple has an entire 
document available to help you write 
advanced predicates. 

It seems like it would be pretty 
easy to make a mistake typing predicate 
syntax into code like that. Isn’t that sort 
of like embedding SQL? 

Yes, and Xcode can offer a lot of help 
here. Instead of embedding your predicates 
in code, you can build them graphically 
using Xcode’s data modeller, just like we did 
with the Managed Object Model. To build 
a predicate graphically, select an entity in 
Xcode, then click on the plus as though you 
were adding an attribute. Select “Add Fetch 
Request" to create a new fetch request and 
click Edit Predicate to bring up the graphical 
editor. You can name your fetch requests 
whatever you like. You'll need to retrieve 
them in code like this: 


thereiare no ^ 

Dumb Questi9ns 

NSFetchRequest *fetchRequest 
=[managedObjectModel 
fetchRequestFromTemplateWithName: 
@”capturedFugitives” substitutionVariables:[ 
NSDictionary dictionaryWithObject:capturedF 
lag forKey:@”captured”]]; 

Then just use that fetch request instead 
of one created in code. You can also use 
Xcode’s builder to assemble a predicate, 
then just cut and paste that into your code if 
you’d prefer to keep them there. 

Reloading the whole table when 
data changes seem pretty inefficient. 
Aren’t we trying to optimize things? 

Yes it is, and yes, we are. There are 
a number of delegate methods you can 
implement to get finer-grained information 
about what’s happening with the Managed 
Object Context. With that information, you 
can find out if you just need to update a 
specific table view cell, insert a cell, or 
remove a cell. We took the easier route 
and just asked the table view to reload 
completely. 

What’s with that cache value we 
gave to the results controller? 


The results controller will use that file 
name to cache information like the number 
of items, number of sections, etc. It will keep 
an eye on the data store and regenerate 
the cache if something changes. You can 
also forcibly ask it to remove a cache, but in 
general you shouldn’t need to. 

Our results controller only has one 
section. How do I get it to split things into 
multiple sections? 

Just provide an attribute name 
for the sectionNameKeyPath. The 
NSFetchedResultsController will group your 
results using that attribute and return each 
grouping as a section. You can get really 
sophisticated and create a transient property 
if you want to group them by something 
you’re not actually storing in the database 
and calculate the value using a custom 
getter added to your object model. 


(^^BUUET POINTS —— 

■ NSFetchRequest can take an 
NSPredicate to filter data based on 
logical conditions. 

■ You can express NSPredicate 
conditions in code or using Xcode’s 
predicate builder. 


■ NSFetchedResultsController 
provides highly efficient memory 
management and change 
monitoring for UlTableViews 

■ Be careful about what you put in 
viewWillAppear, as it will be called 
every time your view is shown. 
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DataM^rationeross 

We have some new data lingo to try out, so flex those 
verbal skills... 



Across 

2. viewDidLoad and view_both load views, 

but with different frequency. 

5. The_is responsible for reading and writing data. 

7. Automatic migration is called_data 

migration. 

8. To update the data, we need to_it. 

9. The FetchedResultsController is good at_ 

management. 

10. NSFetchResultsController can_for changes. 


Down 

1._concepts are similar to NSFetchResults 

concepts. 

3. _are used for filtering data. 

4. The new model is the current_. 

6. The Managed Object Context saves new or_ 

items. 


you are here ► 
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DataMi^rationcross Solution 

We have some new data lingo to try out, so flex those 
verbal skills... 



Across 

2. viewDidLoad and view_both load views, 

but with different frequency. [WILLAPPEAR] 

5. The_is responsible for reading and writing data. 

[STORE] 

7. Automatic migration is called_data 

migration. [LIGHTWEIGHT] 

8. To update the data, we need to_it. 

[MIGRATE] 

9. The FetchedResultsController is good at_ 

management. [MEMORY] 

10. NSFetchResultsController can_for changes. 

[CHECK] 


Down 

1._concepts are similar to NSFetchResults 

concepts. [SQL] 

3. _are used for filtering data. [PREDICATES] 

4. The new model is the current_. [VERSION] 

6. The Managed Object Context saves new or_ 

items. [CHANGED] 
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migrating and optimizing with core data 



Your Pata Toolbox 

You’ve got Chapter 8 under 
your belt and now you’ve 
added migrating and optimizing 
data to your toolbox. For a complete 
list of tooltips in the book, go to http:// 
.headfirstlabs.com/iphonedev. 


Pcirsis-tcht 0\)\ 

^toire 

Anally treads ahd whites ihc daia. 

Poes daia migira-tioh, sometimes 

w •• 七 hou 七此 tidily heedihg io load 

the daia. 

Wscs ma PP ih 3 models i-P ih c dhahges 

扣 e too mudh ^ li 9 hWi 9 ht 


Pa-ta Miyatuw 

Core data w 说 1 十七从吵七 

*to au*tow'3"t , ^3llY 

database Aa 呼 s. 

Vcrsio^m^ is used *to kcc\> br^ 

-t^c data m^vatio^s. 

be used 

to add aU^bu-tes ov 
o^tioy\al s*b3*bus. 


Has Wx o* 7 必 ie ， 

，吒、 Ul Ule ^ 


Saving 

The Ma^a^ed Coh-tc^i 
handles savm^ y\cvj or 
i*tcrwS. 


Fi|-tc\rihJ Data 

Pv"cdid3*tcs 3v*c used *fo\r -Pil*tcHhj 

\resulis daia. a 


The pvedidate heeds -to be sci 

七 he hf£FeUhRc<\ucst 
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bob J s not done yet... 


Hey wait... I think 
I*m gonna need 
pictures, too! 



It’S a good tiling 
iPhone comes witii 
a camera... 
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9 camera, map k!t and core 

Proof in the real world 


w 



The iPhone knows where it is and what it sees. 

As any iPhone user knows, the iPhone goes way beyond just managing data: it can also 
take pictures, figure out your location, and put that information together for use in your 
app. The beauty about incorporating these features is that just by tapping into the tools 
that the iPhone gives you, suddenly you can import pictures, locations, and maps without 
much coding at all. 


this is a new chapter 







bob needs a picture 


For fob, payment requires proof! 

Bob is working hard on getting as many fugitives off the 
street as he can, but to get paid he has to document his 
captures. 



I need a picture of the 
arrest when it happens, and since my 
phone has a camera, I was thinking you 
might be able to help out... 


That should be easy enough. 

Bob wants a picture of his catch and he’s 
going to need it to be pretty big — so let’s 
go ahead and put it on its own view. 

Those pictures will be great for 
advertising, not to mention that it will 
speed up payment! 
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Sharpen your pencil 



Here’s what the app looks like so far. Where 
and how should we add photo support? 




Eminamjwl UllB>nbungi 
Fiona WciPfln 


T<rarcay UjirEJn 




Youv ideds hc\rc- 
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a detail view worth flipping over 


r ^^rpen your pencil 
" K Solution 


Spade is 

3 bi-t "tijht down 
hc\rc- l-f wc shv-*mk 
up 七 he spade (or 
七 he dcsdiripiio^ 
WC ddrt rwovc the 
dap-tuve m-Po up 
3 灼 d Ic3vc Voorw 

"the i^cw burtfeon. 


Here’s what we came up with for the photo view. 
It’s similar to the way most utility apps work. 



Caught pho*to. 


SluaJng ocwl narn» hxr 
Crthi&r WWkMrp«L 


Youll y^ttd -to 

sWmk tW»s ^ 

a b ， 七 . 


&ipt 4 邮 I No 

CipPkjn# D 4 P «4 t™ 



Flip OVCV-. 



Tii'is is {\\t 

bo*bto 州 of 

Pov^c bu-bW *to 
*b^c 06*buvc 

bd£>k ovcv- 


Flip over for the detail view! 

It’s about time we used some real animation in our app. 
Since we’ll only want the photo after drilling down through 
to the detail view (what Bob will use to find his fugitive), it 
makes sense to stick it on the back of the detail view. 


This is a really common interface for the utility apps on the 
iPhone. Typically, there will be two views, one with an info 
button on it, and another that is revealed by flipping over 
when the info button is clicked. Our app isn’t a utility app, 
but we can steal the idea to give a nice baseball-card look to 
our fugitive detail view. 


The flipping is just another transition that comes with 
UIKit. We’re going to want a modal view for that last view. 



wtc: TV^csc arc Wnr^ts 
-for v\t%i so pay 

atteyrbiem. 
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camera, map kit, and core location 



ExeRdSe 


Enough planning and hints. Build the view 
and get it implemented! 



Start with the FugitiveDetailViewControler updates. 

The detail view needs a new info button, and an action to trigger the 
new flip view. The info button is just a regular button with the Info Dark 


type. 


Po/t *bo button 



Use a custom animation to show the new view when the 
info button is pressed. 

You already know how to present a modal view, but this time we want 
to do it with a custom animation. The animation you want to use is the 

UIModalTransitionStyleFlipHorizontal. Take a look at the 
UIViewGontroller documentation if you’re stuck on how to use it. 



Build the new CapturedPhotoViewController. 

That’s going to mean a view with a UllmageView and a Done button. 
Don’t forget the action to tie in with the button and dismiss the view. 


Pcrn’t y/ov-v-y about ^ lB0u*tlc*b -fov- {\\t 
UllmayVicw yet ； we'll -to a setemd. 
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ExeRciSe 
Solution 


This one is a whole bunch of functionality that you added 
without much help! Here’s what we came up with: 


o Start with the FugitiveDetailViewController updates 


Add ^ io 



#import ''CapturedPhotoViewController. h 




FugitiveDetailViewController.m 


❺ 


Use a custom animation to show the new view 
when the info button is pressed. 



- (IBAction)showlnfoButtonPressed : (id) sender { 

the view doh-tv-ollcv- 3hd 
opCh up -the -flip View hib. 

CapturedPhotoViewController *controller = 

[[CapturedPhotoViewController alloc] initWithNibName : 

@^CapturedPhotoViewController^ bundle:nil]; d. _ 


controller.modalTransitionStyle = 

UIModalTransitionStyleFlipHorizontal; 

[self presentModalViewController : controller animated : YES] 

[controller release]; 


FugitiveDetailViewController.m 
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■ iibn m 1^1 •基 : ■■■■■■■■■■■ 

Ttuch E^a^OuiWt 
T-mm-H lip InHi^ 


inline inaq hiot on 


U fif 'l Ofrrw-r 

bfKWvl II luGuUwiPr i 






FugtfJvcDv^jNViEwCcinl'fpItcp.Kib 


ODl 




V ™ Wri t 


ItiipviJDi ItJicA 


Njmc 

■ hiii. i ir ntjiii 

■ I ii Jr 

w r^Rt 

Lin sib^na 



a a 


Vltirtf 


T*k I Vi w 

Libil IBounE^J 

Ub«i Lji.Wftr&Md 

■■bfl 〖 C ! _ptu 『 nf T i 

LjJhI ICipCure Dili A ImiEji 

Pliln $^grTWfn_tf fY_a P Ng> 

ripEurNl LjJu-1 




W\rt this up *fco Piles Oyjv\tr, a*t 


the *top 


is uf *to ri 
<Jc *thc di 


dialog 


The iv>-fo butfco 灼 is jus*t a W|Bu*bto 灼 

do^i^uv-cd *m i\\t *mspcd*fco\T as ar\ "\y\(o dark' 
-type- /l/lakc SuV*C you h3VC the simlud'tcd bb 
bav~ m heve *too, so i*t docs^*t Kiddcr>! 

o Build the new CapturedPhotoViewController. 



@interface CapturedPhotoViewController : UlViewController { 

} Dcdlav-c the \/icw Coirbrolle\r and 七 he 

一 -Pov- -the buttem. 

>ressed: I 


(IBAction) doneButtonP: 


(id) sender; 


@end 


CapturedPhotoViewController.!! 


W\\tv\ the dohe button is 

P 代 W v/3h*t "the view 

to go away. 

[self dismissModalViewControllerAnimated: YES]; 



(IBAction) doneButtonPressed : (id) sender { 





CapturedPhotoViewController.m 


o § o J 

oos o" 
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long exercise solution 



jCpn^ ExeRaSe 

SoLutlOH 


This one is a whole bunch of functionality that you added 
without much help! Here’s what we came up with: 

o Build the new CapturedPhotoViewController (continued). 



firm PjciviKSfulEr 




"Bool 


lilt'E U^nftf 


Cjp|ftJicdFhi?tpVi cwCcpntrQll«v_ ib 


ifiw 

C a 叶 M a V n bnUBtr 

U 4 R<ip^UtF 


1 


Doh’t -Po\rgct the but-fcoh/ ’ 
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camera, map kit, and core location 



Tesr DriVq 


Run the app and see the cool animation working! 



㈣㈣ 




Huninigi 


i ml Ami 


Hr4mfy AMl 


Dm 


m 



f^Sbarp your pencil 

W Now the 


Now the views and animations are all working properly, 
what about the image itself? Think about the data model 
when you fill in the blanks below. 


The Ullmage will be stored in the 




The 


and the 


need to be 


again so this will work. 


The 


has to know about the image and where to display it. 


The image has to come from the 


or the 
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sharpen solution 


_ 龜 


Sharpen your pencil 
' Solution 


Now the views and animations are all working properly, 
what about the image itself? Think about the data 
model when you fill in the blanks below. 


The Ullmage will be stored in the 


database 




The database and the data model need to be … iyated again so this will work. 

The tu)rcdPho'to)/jCvyCoh*ty ； ol| has to know about the image and where to display it. 


The image has to come from the .or the 





w 


You’ve migrated the database before, and you’re going to 
need to do it again. Just so it’s handled and out of the way, 
get into Xcode and do another database migration. 



Highlight iBountyHunter 2.xcdatamodel. 


Then go to the Design ^ Data Model ^ Add Model Version 

menu option. You will have iBountyHunter 3.xcdatamodel in the 
iBountyHunter.xcdatamodel directory. 


❺ 

o 


Set the current version. 

Inside the iBountyHunter.xcdatamodeld directory, select 
iBountyHunter 3.xcdatamodel, which will be our new version. Go 

to the Design ^ Data Model ^ Set Current Version menu 
option. 


Add the new field to the new data model and generate 
the new Fugitive class. 

For the image, we’ll need a new attribute called “image” that is a 
binary data type. Then delete the old Fugitive.h and Fugitive.m 
files and generate new ones via the New menu option. 
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camera, map kit, and core location 


The way to the camera... 

...is through the UIImagePickerGontroller. Why? Because our real 
mission here is to pick an image. The iPhone implements image 
selection through a picker that allows you to get your image from 
different places, like the camera or the photo library. 


The UllmagePickerController class has a lot of built-in 
functionality, plus it’s modal, so once you implement it, a lot of 
things start happening without any additional code in your app: 




s. 






CapturedPhoto 

ViewController 





W "fVkevC 。 士 0 || 饮 

tells i-fcs delegate ^ouv 

CapWdPhoWiewCo^oll^ wheh it 

，hc 9^-ts a, the way 

pt 9 t d 士 “ • 仏 d 七 J 

r L hoto L,b ^y ^ iakcv, with 

the 匕 


UllmagePicker 

Controller 


Ullmage 
Picker 
Jontrolle 
View 






The view 心 . 

r：, r 


Now it’s just a 
matter of some 
syntax... 


you are here ► 


441 













ready bake code 



Cope 


Here is some code you’ll need to tie the image picker together. 
This code goes in our CapturedPhotoViewController as part of 
the next exercise. 



CapturedPhotoViewController 

★hints* 


(void) viewWillAppear:(BOOL)animated { 

[super viewWillAppear : animated 丄 

self.fugitiveImage.image = [[[UIImage alloc] 
initWithData : fugitive.image] autorelease]; 



W\\tv\ 七 he view appeals, wcVc 
^o*mg *to allocate 
i\\t database -to 七 Ke v*ic>w i-f 
*thcv-c is or\t- 


- (IBAction) takePictureButton : (id) sender { 

NSLog(@^Taking a picture."); 

UIImagePickerController* picker = 

[[UIImagePickerController alloc] init]; 

picker.sourceType = UIImagePickerControllerSourceTypePhotoLibrary | 

UIImagePickerControllerSourceTypeCamera; 

picker. delegate = self^^- - ^TVis allows the usev-s -fco edi£ 

picker. allowsEditing = YES; ^ 七 ㈣ a 代 dhoosi ^9* 

' Thc is displayed asy^dh^ohously. 

[self presentModalViewController : picker animated:YES]; 


- (void)ImagePickerController:(UIImagePickerController *)picker 

didFinishPickinglmage : (UIImage *) image is dKoscy>, 七 his 

editinglnfo: (NSDictionary *) editinglnfo ^c*ts tailed- 

{ 

self.fugitive.image = UIImagePNGRepresentation(image); 

[self dismissModalViewControllerAnimated: YES]; 

[picker release ]^： _ Remove ihc p'uikcv- 

j v-clcasc the pi^kcv- objed-fc. 
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camera, map kit, and core location 



Time to get some images! Using the code for the image 
picker that we gave you, as well as some of your 
Objective-C skills, and let’s get the images going. 



Import the Fugitive header file and declare a property 
for the fugitive. 

The GapturedPhotoViewGontroller needs to know what fugitive it’s 
working with. Add a Fugitive field and property named “fugitive” to 
the G apturedPhotoViewG ontroller. 



Store the image when its selected and update the 
UllmageView. 

You need to set the image information on the fugitive when the picker 
gives us an image, then make sure the UllmageView is updated when 
the view is shown. You’ll need an outlet for the UllmageView; then 
link it in Interface Builder. 




Add the code for the UllmagePickerController in the 
takePictureButton action. 

Use the code that we gave you to finish up the UllmagePickerController. 
You’ll need to say our GapturedPhotoViewGontroller conforms to the 
UIImagePickerGontrollerDelegate and UINavigationGontrollerDelegate 
protocols in order to make it the delegate. 




Add the “Take picture button". 

Using Interface Builder, you’ll need to create a button that covers the 
entire UllmageView and is then set behind it. Don’t forget to connect it 
to your takePictureButton action. 


Change the FugitiveDetailViewControllers 
showInfoButtonPressed method to set the fugitive. 

You’ll need to pass the fugitive information along to the 
G apturedPhoto Vie wG ontroller when it’s created and before it’s pushed. 
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ExeRciSe 


Here’s all of the pieces put together to implement the button... 


#import ''Fugitive .h ; 


o 



Import the Fugitive header file and 
declare a property for the fugitive. 

Qinterface CapturedPhotoViewController : UlViewController 

<UINavigationControllerDelegate , UIImagePickerControllerDelegate> { 

UllmageView *fugitiveImage; 

Fugitive* fugitive; ^|| oM so y/c ufdatc the Ullma^cV.cv/ 

} 七 he sclcdtcd 

©property (nonatomic, retain) IBOutlet UllmageView ^fugitiveImage; 
©property (nonatomic, retain) Fugitive *fugitive; 

- (IBAction) doneButtonPressed : (id) sender; 

- (IBAction) takePictureButton : (id) sender; 


@end 



CapturedPhotoViewController.h 


#import ''Fugitive .h 〃 


❻ 


@implementation CapturedPhotoViewController 

@synthesize fugitiveImage, fugitive; 


Store the image when it’s 
selected and update the 
UllmageView. 


(void) viewWillAppear:(BOOL)animated { 

[super viewWillAppear : animated]; 

self.fugitiveImage.image = [[[UIImage alloc] 

initWithData : fugitive.image] autorelease] 


CapturedPhotoViewController.m 
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camera, map kit, and core location 


o Add the code for the UllmagePickerController 
in the takePictureButton action. 


(IBAction) takePictureButton : (id) sender { ' 

us see that it jets tailed m the 

dcbu^cv-. 


NSLog(@"Taking a picture."); 


UllmagePickerController* picker = 

[[UllmagePickerController alloc] init]; 

picker.sourceType = UIImagePickerControllerSourceTypePhotoLibrary | 

UIImagePickerControllerSourceTypeCamera; 

picker, delegate = self; ^\ Wc tV>e ^ - 

picker • allowsEditing = YES; ^ ^Vc 

[self presentModalViewController : picker animated: YES]; 

>wc pv-csc^*t fidkcv air>d … and do^*t v-clcasc -the doy>*tvollcv 

v/ai*t *to sec v/ha 七 uivt’il y/e yt 七 he dallbadks. 

(void)imagePickerController : (UllmagePickerController *)picker 

didFinishPickinglmage : (UIImage *)image 
editinglnfo : (NSDictionary *)editinglnfo 

self.fugitive.image = UIImagePNGRepresentation(image); 

[self dismissModalViewControllerAnimated : YES]; 

[picker release] ; £ mdc Cort Pala v/arrts *to short bma^ry data, >wc r^ttA 

*to yt *m-foVma*tioir> ou*t o( *thc Ullma^c- 

1/Ve CoY\\/tri *to d PN^ \rcp^rcscir>*tatioir> (or *tV>at 

(void)imagePickerControllerDidCancel : (UllmagePickerController *)picker 


[self dismissModalViewControllerAnimated: YES]; 
[picker release]; 




- (void)dealloc { 

[fugitive release]; 

[fugitiveImage release]; 

[super dealloc]; 

} 

@end 


y^U Y\tt& *to VCmCmbcV* *to 

v-elease *thc pidkcv doy>*tv-ollcv 
oy\U you vc gotten *thc 


lh 


CapturedPhotoViewController.m 
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exercise solution 



E 賊 RciSe 


Here’s all of the pieces put together to implement the button... 



Add the %% Take picture button". 


jTh 

Ca p [u r M PfKnoV1 twCofvufilE e r ■ i b 

s; El m 

u A 

^urrh Fiiij 



CkmiR 

tmA litip^nivr 

rajalnnsi Jkillpn fTmp iurir . 口 riadcl d pb^tsil 

Imjvc Vim 
Rpundc^ Rtri Bun^rn 



Charge )t 

w Tap iicv-c *to add a ; 
s'mtc its bAmd p*i^*tuv-c, 
yoi/11 0 K\ly see it I*f tV^cv-c s v\o 


This is 3 little "tough "fco 
out, but the butfcoh is behind 

"the Uffnr^el/iev/. 


o Change the FugitiveDetailViewControllers 

showInfoButtonPressed method to set the fugitive 


- (IBAction)showlnfoButtonPressed: (id) sender { 
CapturedPhotoViewController ^controller = 

[[CapturedPhotoViewController alloc] initWithNibName : 

@^CapturedPhotoViewController^ bundle : nil]; 

controller. fugitive = self. fugitive; |/Ve jus 七 *to se 七七 k -fujitivc 

controller . modalTransitionStyle = _ 七 pv-ofc\rty added *to 

UIModalTransitionStyleFlipHorizontal; Cap*tuV"cdP^o*to\/>c>wCoir\*bv-ollcv-. 

[self presentModalViewController : controller animated:YES]; 

[controller release]; 

} 



FugitiveDetailViewController.m 
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camera, map kit, and core location 



TesT DriVq 


Build and run to see your new picture view in action. 


fik r\ n 


StrnyULun Z.l \ Otibuy 

□vcivivw 


■RoiJtniyMyinTpr Dphuqgpr Ccvn cnlf 1 


% 




BrvjkiKJiiiEi Emld jjpet Run 




H 

PiATVC 


Ocj ，LuHr 




2DU^-Q^^21 

1 Q 0 ^-D 9-21 


ffi I ■“ mjiejiught 
ILVJSl ljibt)i B 


does *tWis mcar\? 


IfptAEtud dt 31iITsOl -040$.] 

20 时-时 -3eI i«4*0v t i vlmf did loud.... 

2 丄 ；i 17 i ■ !}4Jt itsamyjiuiito e e 107 1 vi«u did 1«34 .... 

iDeimeyii'uiitiirEti^dOQ^a? i TDrg-giiBQ tfaii eapc!ir<4 vihgglt. 
21^ 17 Hi i BBUHty»untiflr[ H4S0B ： 2D7 || Tnk Ifig ji pi etura- 
ZU ITjD^.II Ji k bcmntyHiJii tn r [ H4AQS l 2D? | *** j/LiilrAi ^ Qgi upp B. 
ftxcu-pt li>n II'nvA.I k dilrgionritEiccfiiit ici& F raihUjariL ^kvurEfl 1 nat 

200S~&3_S:ll 21 j 17ifl4.3l4 lboikatylCimtar|il4«0BLlQ11 _ 

io§a%iif m 

44 “| 99 』 

i 扣 H 

3137 495 ^. 

ZSMO? ： 9 p 
muiii 
ritAliH, 

[ 3 ftiu 剛叫 r^rrmnaf^d 




AgW It crashed ! 





What’s wrong? Think outside the simulator here... 
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the iPod Touch is different 




Right! And neither does an 
iPod Touch. 

The simulator is reacting to the fact 
that you are asking for the camera and 
it doesn’t have one. But more than the 
simulator not having the camera, the 
iPod touch doesn’t either. 

Who cares? Apple. 


do^-t V^ave ms'idcv- o\r 

The iPhone the only device using apps ^ ^ 一 3 ^ W 

One of the things that Apple requires when ^oij^pdiease 
an app is that it can work on all device^ that can run apps, 
which for now includes the iPod Touch and the iPhone. 

Part of the approval process for apps is that they are 
checked for compatibility with the iPod Touch. 

All this means that you need to be aware of when your 
app may be straying into areas where an iPhone behaves 
differently than the iPod Touch. 


How many 
ctifferences are 
tkere, really? 
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camera, map kit, and core location 



Paa] Puzzjc 


Your job is to take items from the pool and 
place them into the list for the iPhone or 
iPod Touch. You may not use the same 
item more than once, and you won’t need 
to use all the items listed. Your goal is to 
make a complete list of the functionality 
for the iPhone and iPod Touch. 


iPod Touch 


iPhone 


Note: each thing from 
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pool puzzle solution 



Paa] puzzjc 

Your job is to take functionality from the pool 
and place them into the list for the iPhone 
or iPod Touch. You may not use the same 
item more than once, and you won’t need 
to use all the items listed. Your goal is to 
make a complete list of the functionality 
for iPhone and iPod Touch. 


dah get some 
i^-Po about \ocai 
-Pv-om l/Vi-pi. 


lOh 


iPod Touch 

iPod 

Run apps 

Video viewing 
Limited location 

Accelerometer 
Wi-Fi 


XW»S OY\t 
\)t 



This list will 
change. 

Apple is always 
coming out with new 
devices and updating 
capabilities. You need to check! 


Watch it! 



Video viewing would’ve 

the speaker? 

GPS 

Accelerometer 

Wi-Fi 

Cell phone 
Camera 

External speaker 


Video recording 
Magnetometer 




Note: each thing from 
the pool can only be 
used once! 
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camera, map kit, and core location 


There's a method for checking 

With all of these little things that can be different between 
devices, pretty much every time you go to use something from the 
device, you need to check and see if it’s there. For the camera, the 
UI ImagePickerController has a method to check. 


[UIImagePickerController 

isSourceTypeAvailable:UIImagePickerControllerSourceTypeCamera] 

Sm 仪从 Vc \^o 

a souv-tc, -to see 

4 仏 c souvtc you v/a 扒七 * s t\\crc 

In our case, we have another option: the photo library. If there’s no 
camera, we can get an image from there instead. 






So what happens when the user taps the “Take 
a photo” button? You check for the camera, then 
what? What’s the user flow? 
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action sheets 


Prompt the user with action sheets 


Action sheets slide up from the bottom of the page and give the user options 
to proceed. It’s similar to a modal view because the user has to address the 
action sheet before they can move on to anything else. Action sheets are really 
straightforward to use: they take strings for their buttons and have built-in 
animations for appearing and disappearing. Our code for the action sheet has 


some standard stuff included: 

"tKc d 匕七 ioh 

UIActionSheet *photoSourceSheet = ^ 3hd pass it 3 "title. 

[[UIActionSheet alloc] initWithTitle: xl All attics shccis a da^dcl 

(^Select Fugitive Picture" bu«tW so you dismiss \i, 

delegate : self cancelButtonTitle : @"Cancel" r - ^ jus*t like modal v*ic>ws. 

destructiveButtonTitle : nil 



otherButtonTitles : @^Take New Photo” 
Existing Photo 〃， nil, nil]; 

a I khow -this 
w,11 delete all r,y stu^. PI 伽 do butU 

is -the dcstv-u^tivc butfcoh. 


rr 


Choose 


Pcdlav-c *tV>c o*thcv- *t>wo 

buttons dr>d youVc do 灼 c. 


TW、s WtW wouW 

m ved- Wc 

dU’t V>avc ov>c. 


[photoSourceSheet 
[photoSourceSheet 


showInView:self.view]; 
release]; 


\JiA\Vt tv>c 




vclcasc 


Well use action sheets to let the user pick the 、 _cd 、 ateV/ 

image source 


>WC 


We know that our options are to use the camera, use the photo 
library, or cancel, so we’ll need to implement the behavior for 
each option. 


happens caA 
o-f -these bu*t*toi^s? 



6\o bo i\\t camera, -take a fidWc, a^d i\\tr\ dome badk av\d 
fu 七 you^r I 眯 ay *m*to i\\t Furtive. Out you \\By\A o\\ -to 

UllmagePickerControllersourceTypeCamera, 

iVII handle *thc v-cs*t- 

/ 

/ 6\o *to pho-bo lib\rav-y, pi^k Br\ Br\d Con\t 

bd^k 扣 d s*tu-r-r 七 imd^e *m*to Fugitive- 

_UI 工 magePickerCont roller Sour ceTypePhotoLibr ary 

handles *thc \rcst 



6\o batk *to 七 he irwa^c 


view. 
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camera, map kit, and core location 


^harpen your pencil 


Implement the action sheet! There’s a lot here to think 
about since we’re changing the flow of the app a bit. 



Modify the takePictureButton action to include the 
action sheet. 


iBountyHunter needs to check for the camera, and if there is 
one, the user gets to pick whether to use the camera or an existing 
picture. If not, the app should just go straight into the photo 
library. 



丁 his is whc\rc the 

3 乙 tioh sheet domes 



Implement the delegate methods for the action sheet. 

Here’s enough to get you started. Think about the options for case 1 
and the default, and make sure you release the picker and present the 
view. Also don’t forget to declare the UI Act ion Sheet Dele gate 
in the header file. 


- (void)actionSheet:(UIActionSheet *)actionSheet 

didDismissWithButtonlndex:(NSInteger)buttonlndex { 

UllmagePickerController* picker = 

[[UllmagePickerController alloc] init]; 

picker.delegate = self; 

picker.allowsEditing = YES; 

switch (buttonlndex) { 
case 0 : 

NSLog(@〃User wants to take a new picture .’’）； 
picker.sourceType = 

UIImagePickerControllerSourceTypeCamera; 

break; 



Make your code readable! 

We divvied up the implementation code into three #pragmas: the 
takePictureButton code, the UllmagePickerController code, and the 
action sheet delegate methods. 


•m. 
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sharpef? solution 


«^harpen your pencil 


O 


The action sheet should be ready to go and 
your app has a good user flow now... 


Modify the takePictureButton action to include the action 
sheet. 


1 .r 

tWis *to SourceTypePhotoLibary 

y/arrt -to see y/orkmj ort the 


-( 工 BAction) takePictureButton : (id) sender 
NSLog(@’’Taking a picture .’’）； 

if ([UllmagePickerController 

isSourceTypeAvailable : UIImagePickerControllerSource 
NSLog( 

@〃This device has a camera , ask the user what they want to 


jO\A 

SimulaW 


: eTyp 


eCamera]) { 


do.") 


UIActionSheet *photoSourceSheet = 

[[UIActionSheet alloc] initWithTitle:@"Select Fugitive Picture" 

delegate : self cancelButtonTitle : @’’Cancel’ 
destructiveButtonTitle : nil 

otherButtonTitles:@"Take New Photo", @"Choose Existing Photo", 

nil, nil]; 

[photoSourceSheet showInView : self.view]; 

[photoSourceSheet release]; 

} 

else { // No camera , probably a touch 

NSLog(@〃No camera available on the device. Defaulting to library .〃）； 
UllmagePickerController* picker = [[UllmagePickerController alloc] init]; 
picker.sourceType = UIImagePickerControllerSourceTypePhotoLibrary; 
picker.delegate = self; 
picker.allowsEditing = YES; 

[self presentModalViewController : picker animated:YES]; 




CapturedPhotoViewController.m 
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camera, map kit, and core location 


❺ Implement the delegate methods for the action sheet. 


@interface CapturedPhotoViewController : 

UlViewController <UINavigationControllerDelegate, 

UI Image Picker Controller Delegate, UIActionSheetDelegate> 




CapturedPhotoViewController.h 


- (void) actionSheet : (UIActionSheet 

*)actionSheet didDismissWithButtonlndex : (NSInteger)buttonlndex { 

UllmagePickerController* picker = 

[[UllmagePickerController alloc] init]; 

picker.delegate = self; 

picker.allowsEditing = YES; 

switch (buttonlndex) { 
case 0: 

NSLog(@"User wants to take a new picture .’’）； 
picker.sourceType = 

UIImagePickerControllerSourceTypeCamera; 
break; 
case 1 : 

NSLog(@"User wants to use an existing picture."); 
picker.sourceType = 

UIImagePickerControllerSourceTypePhotoLibrary; 
break ; 
default: 

// They picked cancel 
[picker release]; 


return; 


Captured Photo 
ViewController.m 


[self presentModalViewController : picker animated:YES]; 


,oes 


it work? 
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test drive 




TesT DriVq 


Fire up iBountyHunter and drill down through a fugitive to the point of taking a picture. 
If you’ve used the SourceTypePhotoLibrary in the takePictureButton 
code, you’ll get everything to work and see the action sheet. 



TVic sV^cct pops uf, a^d 

oi\Ct you select ^oosc 
pV^o*to • 





… you laughed ihio the pho-to 

lib\ra\ry a^d you ^ selcd a phot>. 


L 6 ee| Blt^ - 

It might be time to register with Apple’s Developer Program. If you do, 
you can install the app on your actual iPhone and test it yourself. Check 
out the appendix at the end of the book to help you walk through the 
provisioning process to make it work. 
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camera, map kit, and core location 


Doesn’t iPhone 3GS support video 
now? How do I get to that? 

It’s another media type you can access 
when you use the UllmagePickerController. 
By default, it uses still images, which is what 
we want for 旧 ountyHunter. 

What about the whole augmented 
reality thing with the camera? Can I do 
something like that? 

Yes. You can give the 
UllmagePickerController a custom overlay 
view to use if it invokes the camera. There 
are still limitations on what you can actually 
do in the camera view, but you can overlay it 
with your own information if you want. 

What’s with the allowEditing 
thing we turned on in the 
UllmagePickerController? 

The picker controller has built-in 
support for cropping and zooming images 



if you want to use it. The allowEditing flag 
controls whether or not the users get a 
chance to move and resize their image 
before it’s sent to the delegate. If you enable 
it, and the user tweaks the image, you’ll be 
given editing information in the callback. 

Do we really have to worry about 
the iPod Touch? 

Yes. When you submit your application 
to Apple for inclusion in the iTunes App Store, 
you specify the devices your application 
works with. If you say it works, Apple will 
test it on both types of devices. They also 
run tests where your application cannot get 
network access to ensure you handle that 
properly as well. Think defensively. Apple is 
going to test your application in a variety of 
scenarios. 

Is there any way to test the camera 
in the simulator? 

No. What we've done is about as 
close as you can get, which is to implement 


the code for the camera and test it with the 
photo library. You've learned a lot so far, and 
lots of the functionality that you're moving 
into has outgrown the simulator. GPS 
functionality, the accelerometer, speaker 
capabilities, all of these things can’t be 
tested at the simulator, and to really test 
them, you’ll need to install them on your 
iPhone. 

What’s the deal with Apple’s 
Developer Program again? 

In order to install an app on your 
device or to submit an app to the App 
Store, you need to be a registered iPhone 
developer with Apple. The fee currently is 
$99. Even if you want to just install an app 
for your own personal use, you'll need to be 
registered. 

Look at the appendix for more detailed 
directions of how installing an app on your 
phone actually works. 


Let’s skow 
it to Bok“ 


you are here ► 


457 


location is important 


Pob needs the where, iw addition to 
the whew 

You’ve given Bob a way to record the proof he captured 
someone with a photo, and an easy way to note when it 
happened, but what about the where? 



Cool—I love the 
pictures—but I need 
location info about the 
grab, too. 


Bob has a jurisdiction problem. 

There are rules about where Bob can nab 
criminals, so he needs to keep track of where 
the capture occurred. 

The easiest way for Bob to keep track of 
these things is by recording the latitude and 
longitude of the capture. 
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camera, map kit, and core location 


^Sharpen your pencil 


How are two new fields going to affect the app? Use 
this space to show where, and on what view, the 
latitude and longitude info will end up. 


㈣ Wve 



What needs to happen to the data model and the data itself? 
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sharpen solution 


^Sharpen your pencil 

Solution 


Here’s what we came up with for the new 
view and the data changes: 


This 
be 3 



Smdc v/cVc lo>w 

。於 s ? 36C m >/•” 

y,cVc 50^5 -to '• 气， 

lat»Wc Um’Wc 


What needs to happen to the data model and the data itself? 

The ddidbdse heeds -fco be updated ； y/cVc gomg -fco be a la*titudc d^d loh^ituclc 

value m dcj|rccs. 79.h?.M.'fcK^ , ??.!! r '. .ih?. ddidbdse) /thcyll heed to be broken up *m*jbo ty/o hey/ 
•atbdbiA/bw . ior. .th.c .F^itiyc. dass：. laiitude. and. J.Q^gi-tvide.. . 
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camera, map kit, and core location 


X 


LOCATION CONSTRUCTION 


Get into it and get the app ready for the capture coordinates: 


Implement the new fields in the view for the location 
label and the latitude and longitude fields. 



Migrate the database again and produce the new Fugitive 
class with the latitude and longitude fields. 

x ^ called thcrw 

ahd daptuircdloh av\d made 
type “Double”. 
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location construction 


LOCATION CONSTRIJCIION 


Get into it and get the app ready for the capture coordinates: 



Implement the new fields in the view for the location 
label and the latitude and longitude fields. 



FugitiveDetailViewController.h 




@synthesize capturedLatLon; 

capturedLatLon.text = [NSString stringWithFormat 

%.3f", [fugitive.capturedLat 

[fugitive.capturedLon doubleValue]] 


FugitiveDetailViewController.m 






Fu 9 ill w[>et ai J Vicvb<lQ-nt iQiller.xi b 




a 




Name 


IV [M 



lAbt\ Lac Lon:) 



BHamU 

- i^urfl^ynLvr.i.q.i^ciKm 

* 


R 士 rfncing Quckts 

Lj^uivdLjffLun 

Ntn Kehrencmp ■Utrtlet 


I Ah#l 


f1h_i bwiivi 



added 'the The values W\W be 

La 七 Loy\ -f ield hcv-c. added V>cv-c 

七 -furtive is 
dap*tuvcd- 
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camera, map kit, and core location 



Migrate the database again and produce the new Fugitive 
class with the latitude and longitude fields. 




4iK 



fugjiwfnrrjiilVlPivr-nnid'fiilfr m 
L 却 (!LK>edPhc^DVi«wCon^D^Er.m 

._ ⑽ 


^aupfp^i 


The v\t^i -fields, daf*tuvcdLa*t 

a,d tai^cALor, arc boih 。師 _ 

¥ “Double . 、 dmunryHunirr -tsqllEt 


WcVc uf *bo 'iBour>*tYHu^*tcv- 
^.^daiamodcl. 


I iigur 

fug nivfnrrjhiruiFivi UiR 

ifuunlvHunliP^LiJijiljrri^ilcrd 
iUoLNitv^umttr..vcd3tamiKjd 
lAmuirYHiMiEr-r TudnumndM 
ii-tiLr-JiLyHij'nler l.ALddtiinuidel 


tfvlin 


IH^iimyMunrrr 4 
▲ Ah% Lli 


MfflirjdTiarlr I i QjFikglilMP i 


Kr-ofMrt^ 

鼻】 KIkI 

1 VP« or 

bfluruy 

ATcrlhiiEf 

nrrlmjil 

cipldate 

Ai^nbute 


^jp-lurctt 

AUftbiiEe 

tu?l 

/jp-iurr-Fll ji 

AnrlhiiEf 

nmihlf 

cip1yr£dl.on> 

Al^nbute 

Dwjbte 

dfiK 

AlCribuEtp 

Siring 

luflLt^elD 1 

AuKbutl 

ftnl n 

\mngt 

AiErlhuci" 

RiFury 

nime 

AlErlbuEa 

String 


OK so rd bet you can get 
that from the GPS on the 
iPhone, but didiVt you just 
warn us that the iPod Touch 
doesiVt have that? 


O 


That’s true, but you’ve got 
options. 

You may remember back in that pool 
puzzle we said something about the 
iPod Touch being able to handle limited 
location. The iPhone (and iPod Touch) 
have more than one way to get at where 
you are in the world. 
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core location 


Core Location can find you in a few ways 


GPS is the first thought most people come up with, but the first generation 
iPhone didn’t have GPS, and neither does the iPod Touch. That doesn’t 
mean that you’re out of options. There area actually three ways available for 
the iPhone to determine your location: GPS, cell tower triangulation, and 
Wi-Fi Positioning Service. 

GPS is the most accurate, followed by cell towers and Wi-Fi. iPhones can use 
two or three of these, while the iPod Touch can only use Wi-Fi, but it beats 
nothing. Core Location actually decides which method to use based on what’s 
available to the device and what kind of accuracy you’re after. That means 
none of that checking for source stuff; the iPhone OS will handle it. 


Allocate 


CLLodatiort Marker ， 


Youll r\ttA *to pass \y\ 
ad^uv-a^y. \0 mc*tc\rs is -f mc 
-fov Bob- 


self . locationManager = [ [CLLocationManager alloc] init] ; -IroV" Uob- 

self.locationManager.desiredAccuracy = kCLLocationAccuracyNearestTenMeters; 

self.locationManager.delegate = self; 

[self.locationManager startUpdatingLocation]; 


o^t P os*.t.o^ w«ll start 

batk delegate U you ^ use. 


Core Location relies oh the LocationManager 

To use Gore Location, you simply need to create a location manager and ask 
it to start sending updates. It can provide position, altitude, and orientation, 
depending upon the device’s capabilities. In order for it to send you this info, 
you need to provide it with a delegate as well as your required accuracy. The 
CLLocationManager will notify you when positions are available or if there’s 
an error. You’ll want to make sure you’re also properly handing when you don’t 
get a position from the location manager. Even if the device supports it, the users 
get asked before you collect location information, and can say “No” to having their 
position recorded (either intentionally or by accident). 





Where should we implement this code in 
ourapp? 
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camera, map kit, and core location 




Yes, and a new framework. 

To keep the size of your app small, Apple 
breaks apart functionality into libraries. 

As you start adding new functionality, like 
Gore Location, you’ll need to start adding 
frameworks. Since the Gore Location 
framework isn’t included by default, we 
need to go add it. 
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core location framework 


Add a new framework 


So far we’ve been spoiled and have used default frameworks, or they’ve 
been imported with the template. Now that we’re branching out, it’s 
time to add the Core Location framework to the app. 


Highlight the frameworks folder and right-click to 
navigate to the Add — > Existing Frameworks. 

option. Then select “Core Location” and Add. 


The 灼 ew 

will be listed heve- 


ii s. __ A n k 




d- 



l/a -ir iDm ■ 

Lw LUh d-M 


I#feff7¥f I 

# Pil*rf|l| fT—^ jm 

-■- 
■ ; apAirari I nil ■ Bp ,wm 

_ Fv| ■yhUv.Iu Iwii -lifaC 

^ P»p ■ •m 
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CwRtuf V ■钃 

OwlfliflXI, 

SMU^JL 




* riv ：| 

^ ^pp liwfliifirVBv^'pnl jp% 

^ Ci««ih liiiP a !iMCa i nfr , Ji# 

">• K&#Tf4.<pnr-^B«i4 
r 「 _ I 

h^P^UHLi r pBTBH 
P fN ^ ■■■Afiiiv. h 

■ Ai ■fl|l| 


■卵 


I 垂 13 


■ r.riki 

LlKlffliW 


then update the header file 

We still need to declare ourselves as conforming to the 
GLLocationManagerDelegate protocol and add our property. 





I IP' 1 !£!•£* ru 






-i'Lal#'l hi 


H lEfC 
« °i ■» P iP ■ ■ 


|冊 I I■ 

B 鳳 ■ ; If 


llCIfrli ! 


■ I i a a, I § it- pBI 

m ii u Ibb»b 


#import < UIKlt/U mt .心 ^ — UUe 如心 CceLcaW k. 

#imp ort <CoreLocation/CoreLocation.h> 

#import ''Fugitive .h" 

CLLocationManager ★HocationManagf 
@p — ( 一 ― 一 — 一 。— • 


• a • ■ •垂 
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camera, map kit, and core location 




Your job is to be tire developer and figure 
out wheve you’re going to implement Core 
Location into our user flow. Assume that 

Bob needs the location and 
date and time to marl^ a 
capture. 



What method will be used to kick off Gore Location in the detail view? 


What happens when the location is returned to the view controller? 


What happens if Core Location can’t get anything or the user disables it? 


When will yo 


u shut down Gore Location? 


What about other devices? 



Core Location inhales batteries. 

Making frequent calls from your app to find locations will 
quickly drain batteries, since it turns on the GPS/cellular/ 
Wi-Fi receiver. That’ll lead to upset users and cranky 
iTunes reviews. Keep it to a minimum! 
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be the developer 



Your job is to he tire developer and figure 
out M^iere you’re goin 贫 to implement Core ^ 
Location into our user flow. Assume that 

Bob needs tire location and 
date and time to marl a 
capture. 


What method will be used to kick off 
Core Location in the detail view? 

Code. .ip.wtiakzjci.Cprc . 

Loda*tioh \ y \ *thc viewW/illAppcar -for 七 he 
de-bail view. 


o What happens when the location is returned to the view controller? 

Well know *the loda*tior\ mahayv- 匕扣 jrt 七 he durrerrt posi-tio^. |-f 七 he user r^avks *thc -fugitive as 
dap*tu\red) we Y\ttA *to yt *thc duvrerrt position -from *thc loda*tioh mahayr a^d update *thc -fu^i-tive. 


- (IBAction) capturedToggleChanged : (id) sender 
NSLog (@〃Toggling the captured toggle .’’）； 
if (capturedToggle.selectedSegmentlndex 
NSLog (@’’Dude got captured .’’）； 
NSDate *now = [NSDate date]; 

now; 


0 ) { 


Ua 七 ^ 诎⑼伙 e ^ ^ CS 

to^brol 


fugitive.captdate 

fugitive.captured = [NSNumber numberWithBool:YES]; 

CLLocation *curPos = self.locationManager.location; 
fugitive.capturedLat = 

[NSNumber numberWithDouble : curPos.coordinate.latitude]; 
fugitive.capturedLon = 

[NSNumber numberWithDouble : curPos.coordinate.longitude]; 


else 


nil 


fugitive.captdate 
fugitive.captured = [NSNumber numberWithBool:NO]; 

fugitive • capturedLat = nil; ^ , uSCS 0 V,\ C dts ^ov 

fugitive • capturedLon = nil; Remember, smte Lor , KfeKumbcvs 

} 高嘴备 ir e 

Wat -.-t U label. 

capturedDateLabel.text = [fugitive.captdate description]; 

capturedLatLon.text = [NSString stringWithFormat : @ 〃％ •3f, % .3f 〃， 
[fugitive.capturedLat doubleValue], 

[fugitive.capturedLon doubleValue]] 
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FugitiveDetailViewController.m 











camera, map kit, and core location 



What happens if Core Location can’t get anything or the user disables it? 

Sihdc Bob heeds loda*tioh ih-fo y/hch \\t marks d -fugitive as dap*turcd, y/dl 
r\ccd to disable dap*turcd swi-tdh i-f y/c gc*t 



(void)locationManager : (CLLocationManager *)manager 
didUpdateToLocation : (CLLocation *)newLocation 

fromLocation:(CLLocation *)oldLocation { 
NSLog(@〃Core location claims to have a position . r, ) 
capturedToggle.enabled = YES; 


•to y/am 如⑽ thy mark a 〒於 as ^ftuved. 


■to 

(void)locationManager : (CLLocationManager *)manager 
didFailWithError:(NSError *)error { 

NSLog(@’’Core location says no-go on the position info.") 
capturedToggle.enabled = NO 




FugitiveDetailViewController.m 


When will you shut down Core Location? 

VJtW shu*t i*t dovm vi\\cy\ we leave -the drtail view. 


- (void) viewWillDisappear:(BOOL)animated { 

[super viewWillDisappear : animated]; 

NSLog (@ "Shutting down core location. •.’’）； 

[self.locationManager stopUpdatingLocation] 
self.locationManager = nil; 



FugitiveDetailViewController.m 



What about other devices? 


IVlcVc ^oodi* All do is *tdl Core Loda*tior\ 七 he wc wa^-t i*b deals wi*th 

rest So, 七 he iPod Toudh yt jus*t best data i*t c^y\, dhd well yt 


Implement all this code and 
then take it for a spin... 
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no dumb core location questions 


thereicire no ^ 

Dumb Questi9ns 


We start and stop Core Location in viewWillAppear and 
viewWillDisappear. Is that normal? 

It's normal to start and stop Core Location as you need it. It 
uses a fair amount of power while it's running, so it's best to shut 
it down if you don't need it. This gets a little tricky because Core 
Location can require some time to get its initial position information. 
To try and make that a little smoother for the user, we enable it as 
soon as the view appears to give it a head start before the user 
needs the location. 

Is there any way to speed up that initial position? 

Core Location will try to cache previous position information 
so it can give you something as quickly as possible. Because of 
this, if you're really concerned about accuracy, you should check the 
timestamp sent along with the position information to make sure the 
position is recent enough for your needs. 

Does location accuracy impact things like startup time or 
battery usage? 


Absolutely. The more accurate a position you ask for, the more 
battery Core Location will consume and it will potentially take longer 
to figure out. Lower fidelity information tends to come to you faster. 
Use whatever accuracy you need for your application, but be aware 
of the implications of high resolution information. 

Is there a way to just wait for Core Location to have a 
position rather than having it call back to the delegate like that? 

No. Core Location, like a lot of other frameworks in iPhone 
OS, calls back asynchronously as data is available. Network access 
generally works this way as well. You need to make sure you keep 
your users informed of what’s going on in the application and what 
they can and can’t do at the moment. For example, we disable the 
Captured button if there’s no position information available. Other 
options display a wait indicator (like a spinning gear) or display 
position status with a disabled indicator like an icon, button, or label. 
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camera, map kit, and core location 



TesT DriVq 


Implementing Core Location really wasn’t that hard, but making it work in the user 
flow required a bit more work. Now that it’s all done, you should be up and running... 



To 七 c ^ a 代 Bob I 

—a 七 c i 鈿乩 

W.II k\tk ^ Core 


F'i ： gg^ Ford 




HUlng puytfry, 


Bounly 




vou add ta^WcdTo^Ic cwablcd 
NO ； *b ^ vicv/lA/'illA^cav-, 七 ” 
i\^t usev tar^i 栋 c to^bro\ 

fec-fo\rc Core LotaW sta 士 
V"C*buv-y>m^ updates. 




iAI 


CiipLii Dpk t Hm vs^m-n 矚 ja 4W 
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yp^feui •… 
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2H4-d#-K0 l^s4l eII lEhHivL'irVuiitvz'l U3 ] r^ltlvnLlBLViviiCqiitarailf r Bkll 

I .ffMK … ■ 


Sft 4 ^niY'liunriy Lpunrh*^ 


Q) Jiirf«hinJ 


Oy\U a position is ve 七 uwd ， 七 he 
daf*tuv*cd button is enabled and 七 he 
-f ields av-c populated. 


It’s working! Bot 
skoulct te psyckect... 
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bob gets visual 


Just latitude and longitude 
wow't work for fob 



It’s an iPhone. A map 
would really be more 
appropriate. 

What’s the point of all the network 
connectivity and fancy graphics if 
we just show a text field? With just a 
little bit of code and the iPhone OS 
Map Kit, we’ve got something a lot 
more appealing in the works. 
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camera, map kit, and core location 


Map Kit is new with iPhowc 3.0 

With the latest major iPhone update, Apple opened up the API 
for the maps that are used on the iPhone. The data for the maps 
comes from Google maps, including satellite imagery. 

There’s lots of customization that you can do with the maps, such 
as how wide an area they show, what view they start with, and 
pins and annotations. 

Logistically, using Map Kit is a lot like Gore Location: you’ll 
need a new framework and will have to # import <MapKit/ 
MapKit. h> in the header file. 



Alap ^orwcs v/rth built—m 
support -fo\r pushpins ai spcdi-ficd 


M^Mapl/icw is a dohtvol 
that fulls map iivfoirmatioh 
•(Vom google /Waps. You 

乙如 doh-pigu\rc it -Pov- the 

^o^a\ \road display, salcllilc 
i^agc\ry, o\r a hybv-id, like you 
see 



ov\ 

m-fov-ma*tio\r\ you 
y/ar\*t bo sKow ov\ 
mdf>) you 

youv* ov/r\ \/icv/s -fov 
ar\y\o*tat»oir\s 3r\d 


siioy/ you 

\N^Y\i, like pidWcs, 



Map Kit requires a network connection. 

Since Map Kit pulls imagery information from Google, 
you’ll need to have a network connection for it to be useful. 
That’s not a problem for the simulator (assuming your 
Mac is online) but it could be an issue for the iPod Touch 
and even the iPhone, depending on the location. Map Kit handles this 
gracefully, but it’s something to be aware of. 


Watch it! 


How can we put 
tkat to work? 
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map custom setup 


A little custom setup for the map 

Like Gore Location, it’s not a lot of work to get basic Map Kit 
support going in iBountyHunter. We’ll update viewWillAppear in 
the GapturedPhotoViewGontroller to display the capture location 
on a hybrid (satellite plus road information) map. 


- (void) viewWillAppear : (BOOL)animated { 

[super viewWillAppear:animated]; 
self•fugitivelmage•image = 

[[[Ullmage alloc] initWithData : fugitive.image] autorelease]; 


These values 
allow us "to 
^oh-pigu\rc the 

如 o? the 

dc^ult 

slioy/h. 

^ pull all 

ihis 

-to 

-the 

Mp. 


if ([fugitive.captured boolValue] == YES) 

CLLocationCoordinate2D mapCenter; 

mapCenter.latitude = [fugitive•capturedLat doubleValue] 
mapCenter.longitude = [fugitive.capturedLon doubleValue] 

tteme well pass ih tk value o( the \ai 


MKCoordinateSpan mapSpan; 
mapSpan.latitudeDelta = 0.005 


mapSpan.longitudeDelta = 0.005; 

MKCoordinateRegion mapRegion; 
mapRegion.center = mapCenter; 
mapRegion.span = mapSpan; 


ahd U wheve the fugitive was dapWcd. 

TV^C sizjC o*f map is m 
dcjv-ccs. Wic y/ar\*t ma? 

-to be zoomed m. 


Thc\rc a\rc a -Pew rr»ap types ； hybrid is 
both satellite av\d road ih-pov-matioh. 


self.fugitiveMapView.region : 
self.fugitiveMapView.mapType 

wcVc ^ io 


mapRegion; 

: MKMapTypeHybrid; 


owr view. 



CapturedPhotoViewController.m 
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camera, map kit, and core location 


tJiereiare no ^ 

Dumb Questi9ns 


What’s the difference between Core Location and Map Kit? 

Map Kit is about displaying a map, position-sensitive 
information, and, user interface. Core Location is about getting 
you information about where you are. You can drag and drop a 
map onto your view in Interface Builder; you pass it some values 
and it just works. 

Core Location, on the other hand, returns values to the delegate and 
you need to decide what to do with them. We’re going to take that 
information from Core Location and give it to Map Kit to show us a 
map of the capture location, for example. 


Where do all these frameworks come from? What if I want 
one that’s not on the list? 

The frameworks are included as part of the SDK. The actual 
path to the frameworks varies by version and what platform you're 
developing for. For example, the Map Kit framework we're using is 
here: /Developer/Platforms/iPhoneOS.platform/Developer/SDKs/ 
iPhoneOS3.1.sdk/System/Library/Frameworks/MapKit.framework. 

In general, you should be able to add frameworks using the “Add 
Existing Framework” and not need to worry about a specific location, 
but if a framework isn’t listed or you're adding a custom one, you can 
point Xcode to the actual path. 



Implement the map to show the area where 
the fugitive was captured. 



Add the Map Kit framework and the #import. 

Add the framework just like we did with Gore Location. While 
you’re at it, make sure that you do the #import in the detail view 
to include the Map Kit header. 



Configure the photo view to show the map. 

Rather than adding a whole new view, go ahead and add the map 
to the CapturedPhotoView with the image. Resize the image 
and the button then drag an MKMapView to the bottom half of 
the view. 



Add the outlets and code for the MKMapView. 

Now that you have all the support stuff in place, go ahead and 
add the outlets and the actual Map Kit code we gave you to make 
the map work. Make sure you wire up the outlet in Interface 
Builder. 



Resize 

-the burtton." 


...dy\d use *tV^c 
bo*b*tow> tVic 


viev/ 
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exercise solution 


iPb 

EjteRciSe 
S°tytioH 


Implement the map to show the area where the fugitive was captured. 



Add the Map Kit framework and the #import 


s -the /Wap ^i-t 
-P\ramcwov-k... 


#import <MapKit/MapKit.h> 


@class Fugitive; 


o Add the outlets and code 
for the Map Kit. 


@interface CapturedPhotoViewController : 

UlViewController <UINavigationControllerDelegate, 

UI Image Picker Controller Delegate, UIActionSheetDelega\te> 

MKMapView * fugitiveMapView ; 


©property (nonatomic, retain) 

IBOutlet MKMapView * fugitiveMapView; 

^0 0 I 



CapturedPhoto 

ViewController.h 


❺ Configure the photo view to show the map. 



^ ^ ^ 


r.ijinirrdPhmaWniConcrDllff Mib 
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camera, map kit, and core location 


o Add the outlets and code for the MKMapView. 



Add dll Code -from p. 午 7 午 *to dustomiz^ *thc map. 


- (void)dealloc 



[fugitive release]; 

[fugitivelmage release]; 

[fugitiveMapView release] 

[super dealloc]; 


CapturedPhotoViewController.m 



Tesr DriVq 


Go ahead and build and run the app. You'll need to make sure that you mark a fugitive 
as captured, and that the lat/lon field fills in, then flip over the view to look at the map. To 
try out the zooming on the map you’d use the “pinching” motion on a real device. In the 
simulator, hold down option and then click. 
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test drive 




Tesr DriVq 


To try out the zooming on the map, the “pinching” motion in 
real life, in the simulator, hold down option and then click. 



You 63^ 

* m i\^t ma? av^d 

move \i avowed. 



Sm 乙 C youVc m *tv^c simulate 
lo^3*tior\ y/ill be Cupcv"*bmo> 
Ch) y^o matter w)ic\rc you av-c. 


Excellent! Now all we need 
is a pin to skow wkere tke 
capture kappenect. 
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camera, map kit, and core location 


TlhCSSC 

AHHOtatioHS require a little more wtrk 

Annotations are the little flags that come up when you see a point of interest, 
represented by a pin. The catch? Incorporating annotations means conforming to the 
Map Kit annotation protocol. Map Kit uses an annotation protocol so that you can 
use your existing classes and provide them directly to Map Kit. The downside is that 
means we need to add code to our Fugitive class. 



#import <MapKit/MapKit.h> 



Fugitive.h 


Qinterface Fugitive : NSManagedObject <MKAnnotation> 


#pragma mark - 
#pragma mark MapKit Annotation Protocol 


po\r a 代 katicm ^ 

*to do da^a 

you should a 

separate tlass 

ov-oW V^as a io 

•rb (tompos • 七 <W) ^atV|CV* 

七 ^ addm^odc *to 栋 c 
tlass div-ct-blY* 


Qproperty (nonatomic, readonly) 
CLLocationCoordinate2D coordinate 


- (NSString *) 
- (NSString *) 

@end 


title; 
subtitle 


Da tMs! + 

Tlic p\ro*to^ol \rc^ui\rcs us -fco have a 
tooY&x^it p\ropc\rty, a title, ahd a 
subtitle, (hsicad o( syhthcsizjhg that 
tooYA\^it fvopcvty, well ir^plcmcht it 
ourselves 3hd just v-ctuv-h the ^ugitivc^s 
posi-tioh, hamc, ctd. 


Add *bWis at 

Ca ? WeaPV.oW^Co,Mi^. 


m 


(CLLocationCoordinate2D) coordinate { 

CLLocationCoordinate2D captureCoord; 

captureCoord.latitude = 

[self.capturedLat doubleValue]; 

captureCoord.longitude = 

[self.capturedLon doubleValue]; 

return captureCoord; 


- (NSString *) title { 
return self.name; 

} 

- (NSString *) subtitle { 
return self.desc; 

} 

@end 


Fugitive.m 


[self.fugitiveMapView addAnnotation : fugitive]; 


you are here ► 


479 









iBountyHunter works! 



iBouirrtyHuirrtev 


TesT DriVq 


That’s it! Everything should be working now.You may not have 
noticed as you’ve been working through all this code, but this 
app is huge and awesome! 



Ml 

— — 


Fug Hives 


Randy Whitmore 


RudoEph Qranida 


Sam Romero 


Sartianlha Fox 


Sarah Carr 


Selina liQfdlio 


Stanley Fisher 


Tracey Martm 



^cwnir 




PM 


CEiplurVCI 


Emmanuel Ult^nburg 


Fiona Westin 


George Palin 


Hunter 


Joe Daniels 


N. Winner 


Pe^gy Ford 
Snrah Carr 
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camera, map kit, and core location 



This is 七 

r\C^i 

av>ir>o*tatioir> 
todt you 
added- 



This mvokcs *thc dameva, 
^\\\cM you car\ sec or\ youv- 
r>o*t *tv>c s"imula*to\r. 
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bob approves 


That app is awesome. Were 
going to have a beautiful 
future together... 


Justice prevails! 
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camera, map kit, and core location 



Addi^^Funetionalitycross 

One last time to flex the right side of your brain... 



Across 

2. UllmagePickerController gets images from the_ 

and the library. 

4. The_animation comes with UIKit. 

6. The info circle is just a configured_. 

7. Additional_are needed for MapKit and 

Core Location. 

9. Your app must be able to work on the_ ， too. 

10._sheets are a good way to get a user to pick an 

option. 


Down 

1. The camera cannot be tested in the_. 

3. The iPhone isn't the only_that uses apps. 

5. Besides GPS and cell towers,_can be used 

to determine location. 

8. doesn't work without a Net connection. 
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addingfunctionalitycross solution 


A^ingFimctionaliiycposs 

Solution 


One last time to flex the right side of your brain... 



Across 

2. UllmagePickerController gets images from the_ 

and the library. [CAMERA] 

4. The_animation comes with UIKit. [FLIP] 

6. The info circle is just a configured_. 

[UIBUTTON] 

7. Additional_are needed for MapKit and 

Core Location. [FRAMEWORKS] 

9. Your app must be able to work on the_ ， too. 

[IPODTOUCH] 

10._sheets are a good way to get a user to pick an 

option. [ACTION] 


Down 

1. The camera cannot be tested in the_. 

[SIMULATOR] 

3. The iPhone isn't the only_that uses apps. [DEVICE] 

5. Besides GPS and cell towers,_can be used 

to determine location. [WIFI] 

8._doesn't work without a Net connection. 

[MAPKIT] 
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camera, map kit, and core location 


Your extras Toolbox 

You’ve got Chapter 9 under 
your belt and now you’ve 
added the camera, Core 
Location，and Map Kit to your tool¬ 
box. For a complete list of tooltips in 
the book, go to http://www.headfirstlabs. 
com/iphonedev. 



Pli? •。於 

Comes W|d 
|s ^ bf^\ca\ m-tcr-fadc utilrb/ 
oy\ iP^oy\C- 

Is usually as a modal 


I s Messed th\rou3h the 
w " i^a3cPidkc\rCoht^ollc\r. 

卜 hot Oh all devils ahd you heed 
*W> h^hdlc that 

Allows you h> St\tti 3hd edit ah 

' ma 9 c ^ usc yo^ app di^tly 
4*V"om you\r libv^y. 


View. 
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the end... sort of 



Ifs been great having you here! 

We’re Sad to see you leave, but there’s nothing like taking what you’ve just 
learned and putting it to use. You’re just beginning your iPhone journey, and we’ve put the 
control in your hands. Check out the Appendix after this to find out how to get your brilliant 
iPhone app up and running in the iTunes App Store. We’re dying to hear how things go, 
so drop us a line at the Head First Labs site, http://www.headfirstlabs.com/iphonedev, 
and let us know how iPhone development is paying off for YOU! 
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/ leftovers 

參 


The top 6 things 

(we didn’t cover) + 



Ever feel like something’s missing? We know what you mean... 

Just when you thought you were done, there’s more. We couldn’t leave you without a few 
extra details, things we just couldn’t fit into the rest of the book. At least, not if you want to 
be able to carry this book around without a metallic case and castor wheels on the bottom. 
So take a peek and see what you (still) might be missing out on. 


this is a new chapter 
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internationalization and localization 


Nib files (views, labels, button text, etc.) 

Location or culture-specific icons and images such as flags or text 
Included or online help and documentation 
Static text in your application 



# 1. iHterHationalization and Localization 

The iPhone and iPod Touch are sold in over 80 countries and support 30 languages 
out of the box. Depending on your application, you should consider supporting 
multiple languages and cultures. Internationalization is the process of identifying the 
parts of your application that are culture or language-specific and building your app 
in a way that supports multiple locales. Some of the things you should look at are: 


㈣ 撕 一 




Md »• 

Cptn W^ih FmC^r 

Ue 中 n iM » 

hvril in Finifar 
6pr-n In CiMoi 

Add fa EAokmjrk^ 




ftcrwnE 

tnwwh 




Once you’ve identified the culture or language-specific parts of your application, 
the next step is to localize them. The iPhone OS has strong support for localizing 
resources and separates the localizable resources from the rest of the application 
so you can easily use a localization team or outsource the effort all together. 

Up until now our resources have been included in our application in the .app 
directory. Once you start localizing resources, Xcode creates an lproj directory 
for each localization (locale) you add and moves the locale specific resources there. 
For example, if you provide both English and French translations of your nibs, 
then you will have an en.lproj (or English.lproj) and fr.lproj directories in your 
application. 


Localizing nibs 


Xcode and Interface Builder have built-in support for localizing nibs. Before you 
start translating anything, you need to ask Xcode to create the locale-specific 
directories. 





Vou 63 ^ 冼 a 呼 7 雜 la 呼 ay 
a,d locale o, .PW V>7 ^ 
•，山 Sett.my 一爲⑽ al 

七 ，。灼 al . 




-- iJiigi 呼 b 


o o o • 
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leftovers 


Next click on “Make File Localizable.” Xcode will 
turn your nib entry in the project list into a group 
with each localization listed beneath it. Xcode copies 
your original nib into your default localization. 


'rcsou^cs. 社 youv- 




TW»s is w 七七 

|wf。” -fov- 

a V)u*t 
七 Wis a^v-oatV^ 

-to \ota\\^t av^ 

^t>r\c VCSOUV6C 

like »6or\s ov 
ways. 


The next dialog you’ll see allows you to add 
additional localizations. Select the General tab and 
click “Add Localization.” In the dialog that appears, 
you should enter the country code of the localization 
you wish to add. In our example, we’re adding fr for 
French. 
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localizing sfr/ngs 


Now all you need to do to localize the nib is to double-click on the language 
you want to localize and translate any text. Remember that depending on the 
language, you may need to adjust layout as well. 

For large projects, there is a command-line tool you can use called ibtool 
that you can use to extract all string values from a nib into an external file, then 
merge translations back into the nib later. This allows for bulk extraction and 
translation, but you need to be particularly careful about layout issues as you’re 
not visually inspecting each nib. Once a nib has been translated, you can have 
Interface Builder mark it as locked to prevent any accidental changes to the text 
or layout that could impact your translations. See Apple’s documentation on 
bundles and nib localization for more information. 

Localizing string resources 

In addition to nib text, text in your application that you intend on showing 
the user needs to be localized as well. For example, the Action Sheet used in 
iBountyHunter offers the user the option to take a photo, choose an existing 
one, or cancel. That button text is generated programmatically and needs to be 
translated appropriately. 

For this type of text, called string resources, the iPhone OS uses strings files. 
You’ll generally have one of these files for each language you support. Each file 
contains a description of what the string is trying to communicate, the default 
language version of the string, and the translated version. Like this: 
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Confirms a really bad decision. * 
、 A11 In 〃 = ''All In 〃； 


SS&r— 


’* Cancels the dialog * 
‘Cancel’’ = ''Cancel ”； 


* Title for the important alert view */ 
'This is important 丨〃 =''This is important! 


/* Warns the user about impending badness. */ 
''This will empty your bank account. Are you sure? 
your bank account. Are you sure ?〃； 


tacM V^as ov *^ mal 


'This will empty 
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ftewcratlwg your strings file 


You could create your strings file by hand, but a much simpler way is to have Xcode generate it for 
you. Xcode does this by looking for the localization macros that load the translated text. To support 
localized strings, you should use one of the NSLocalizedString macros, like this: 
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-( 工 BAction) pushMePressed : (id) sender { 

UIAlertView *alertView = [[UIAlertView alloc] 

initWithTitle:NSLocalizedString(@〃This is important! 

@〃Title for the important alert view ”） 
message : NSLocalizedString(Q^This will empty your bank account. Are you sure? 1 

Warns the user about impending badness .’’） 

delegate : nil 

cancelButtonTitle : NSLocalizedString(Q^Cancel ^, @〃Cancels the dialog ”） 
otherButtonTitles : NSLocalizedString(@ 〃 A11 In ”， 

@^Confirms a really bad decision .’’）， 

nil]; 

[alertView show]; 


If you’ve used the NSLocalizedString macros in your code, you can generate your strings file 
by simply running the genstrings command at the command line, like this: 

genstrings -o English.lproj 


You’ll want to run this for each translation you support. This will create a file named 
Localized.strings in the specified locale directory that you can give out to translators. You’ll 
need to add that strings file to your Xcode project like any other resource, but once it’s there, 
the iPhone OS will look in the appropriate strings file at runtime based on the language the 


users select for their device. 

The iPhone OS provides robust localization capabilities, 
including currency, time, and date presentation support; we’ve 
just scratched the surface. Apple provides several documents 
on internationalization and localization, including the 

Introduction to Internationalization Programming 
Topics document in the Xcode documentation, to help you with 
more complex scenarios. 



The iPhone OS caches 
resources! 

t Y i. T If you’ve installed your app 

W3lCh 11 ： before doing translations, 

it’s likely that the iPhone OS 
has cached resources so that even after 
adding translations, you won’t see them 
until you uninstall and reinstall your app! 
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UlWebView 


UlWebView 


The iPhone OS comes with a powerful control called UlWebView that uses Web Kit to handle web 
content. It’s basically the Safari browser in a box. You can use this control to load external URLs 
like a normal browser or to load local content for displaying documentation written in HTML. 
Despite how powerful it is, it’s one of the simplest controls to use. 


To create a UlWebView, simply drop one onto your view in Interface Builder and set up an outlet 
for it in the view controller. 
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Using UlWebView 

UlWebView is extremely easy to work with. To load a URL, you simply send it the loadRequest: 
message with the URL you want it to load, like this: 




NSURL *url = [NSURL URLWithString:@’’http://www•headfirstlabs•com”] 
NSURLRequest ^request = [NSURLR^guest requestWithURL:url]; 
webView. scalesPageToFit = YES; ^ N^URL- Wi*tn 

[webView loadRequest:request]; actual URL v/c 叫扣七 . 


l/\fe y / 扣七 七 he y/holc fay sKoymmrBal 

so y/e enable sdalcsPa^cloFi-t. 
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UlWebVicw properties 

Once you’ve loaded a URL, you can then use the loading property to find out if UI Web View is 
currently trying to load a URL. To stop it, simply send it the stopLoading message. To control 
how the page is shown, you have a few options. You can turn off the detectsPhoneNumbers 
property to tell it to ignore phone numbers in the page its displaying (otherwise it turns them into 
hyperlinks to the phone application). By default, UI Web View will render the page full size. However, 
you can enable the scalesPageToFit property to have it scale the URL’s content to fit the 
screen. If this property is enabled, users can use the usual pinch gesture to zoom and pan around 
the contents. 


UlWebView has built-in support for navigation history as well. It will set its canGoBack and 
canGoForward properties based on whether there are pages in its forward or back history. Typically 
you use those to enable or disable forward and back buttons if you want navigation support. 
UlWebView knows what the history looks like, so you can simply send it the goBack: or goFoward: 
mesages and it will handle the rest. 

Loading generated content 

You can also use UlWebView to load locally generated content (such as displaying HTML help files 
or reports) by asking it to load an HTML string, like this: 


NSString *html = @ 〃 <html><body><hl>Look what 工 can do!</hlx/body></html> i 
[webView loadHTMLString : html baseURL:[NSURL URLWithString:@ 〃 file:///•〃]]; 


The UlWebView supports a delegate, too 

If you want to know more about what’s going on with the UlWebView, you can 
conform to the UIWebViewDelegate protocol and set the delegate on your web 
view. The delegate protocol lets you get notified when loading starts and stops 
as well as gives you an opportunity to inspect links before they are followed. If a 
UlWebView has a delegate, it will send the delegate the webView : should 
StartLoadWithRequest : navigationType : message when the user taps 
on a link before actually following it. You can return NO if the web view shouldn’t 
follow the URL. 
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device orientation 


Pgvicg oriewtatiow and view rotation 

On the surface, the iPhone OS makes handling screen rotation simple. The iPhone and iPod 
Touch each contain an accelerometer that lets the device detect orientation. When you build an 
application using UIKit, the iPhone OS asks the active view controller if it can handle rotating. 
The iPhone OS supports the following orientations: 


Co 灼 s*ta 的七 



The -typical o\ric^*ta*tio)r\ y/i-th "the home 
butfco 灼 a 七 bo-t-fcom. By dc-faul*t *this 

is only view ^o^-tvollcv-s 

SUffOV" 七 . 
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Like pov-tv-ait bu-t with 

•the home bu-t*fco^ at -bop "the 

device- 


The devide is held oy\ its side 
home bu-t-fco^ oy \ -the vijht 


The devide is held oy\ its side v/i*th 
home bu*t*fco^ oy \ -the Ic-ft 


The view controller tells the iPhone OS what orientations it supports 

When the iPhone OS detects that the device has rotated to one of those views, it calls 
shouldAutorotateToInterf aceOrientation : on the active view controller and passes 
in the new orientation. If your view can handle the given orientation, it simply returns YES. If not, 
it returns NO. If you don’t explicitly implement this method, the default implementation returns 
NO for all rotations except UI Inter f aceOrientationPortrait • 

When the iPhone OS needs to rotate to a new orientation, it will notify the view controller by 
sending it the willRotateToInterfaceOrientation: message with the duration that it will animate 
the transition. You can use this method to disable buttons or timers or anything else that could 
cause a problem while the view is changing. Once the animation is complete, you’ll receive the 
didRotateFromlnterfaceOrientation: message, where you can reenable everything. 

The iPhone simulator supports rotations so you can test your application in each orientation. To 
rotate the simulator you can either use Hardware ^Rotate Right (or Left) or (or Left). 
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Handling view rotations 


The easiest way to handle view rotations is to take advantage of UIKit’s ability to autosize your controls. 
To do this, select a control then bring up the inspector on the Ruler page (§€3). From here, you can select 
autosizing anchors, basically edges of the control that will be anchored in place. By configuring the 
autosizing information, you can have UIKit automatically resize the control when the view size changes. 


h n 


BLrmaii ^prr 


The /-bcarr, shapes Oh ihc cd<\cs 
how -the ^ohtv-ol is 
-to -the view. 


Thc the box 

di^ iohS 

^Oh-t\rol is allow -to ^rcsizjc. 

dashcd ihdi^tes ihe 

乙 0 dahho 七 siz^s 

，h A solid |i he 

厂 H 卜咖 the 

^ ihc vicw 虬 



This wihdow ahir^aies 

广七 would happeh io 

the Coy\hro\ as -fchc 
v ' cw ^hahjes shape. 


(h-tev-fade Buildcv lets you votatc 
view youVc y/o\rkihg oy\ a^d sc( 
the au-tosizjhj at 






lVhcr\ simula*bo\r \ro-ta*tcs, view 
匕 oirrbrollev" is *told ； *thc iPhone OS a^ir»\a*tcs 
^ 灼 *thc au*bosizj^^ kidks *m ; 

and button spa^s whole pho^c- 


But sometimes 
autosizing just 

ctoesn t cut it 參參參 


you are here ► 


495 










































rotating different views 


Handling rotation with two different views 

Depending on your application, your view may be sufficiently complex that autosizing just 
doesn’t get you what you want for the rotated view. Alternatively, some applications present a 
totally different perspective to the user in landscape mode than in portrait mode. 
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To support multiple views, you’ll need to either define multiple UlViews in your nib or create 
separate nibs. Then, when your view controller is notified of the rotation, you can change your 
self . view to the appropriate view depending on the target orientation. 



You can only have one object 
for any given IBOutlet! 

If you have similar controls (but in 
different positions or altered styles) 
in your views, you’ll need separate 


outlets for each control. 
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# 4. View animations 


If you’ve spent any time with an iPhone or iPod Touch you know that smooth transitions and 
graceful animations define the user experience. In the applications we’ve built so far, we’ve only 
touched on a few basic animations (like the flip animation used in iBountyHunter). However, 
everything from adding and removing table rows to sliding controls around the screen can be 
animated. 


Ahimatihg table view updates 

If you’re going to add or remove multiple rows in a table view, you can ask it to provide a smooth 
animation (as well as a more efficient handling of updating the table view itself) by sending it the 
beginUpdates message before you start manipulating the data, then an endUpdates when you’re 
finished, like this: 


[self . tableView beginUpdates] ; 

[self.tableView insertRowsAtlndexPaths:insertlndexPaths 
withRowAnimation : UITableViewRowAnimationRight]; 

[self.tableView deleteRowsAtlndexPaths:deletelndexPaths 
withRowAnimation : UITableViewRowAnimationFade]; 

[self.tableView endUpdates]; 
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Animating view and control changes 

Similar to table views, UlViews have built-in support for smoothly animating changes to several of 
their properties. You simply need to tell the view that you want it to animate a change by sending it the 
begin Animations message, describe the end point of the change, then ask it to start the transition by sending 
it the commitAnimations message. The following UlView properties can be animated automatically: 


W|\/icw pv-opev-ty 

Dcsd\rip*tio^ 

-fvamc 

The physical vc 匕七七 ha 七 desdv-ibes 七 he view — 七 he viev/^s o\ri^'m 
By\A sizjC - \y\ supev-viev/^s ^oo\rd'ma*tc system. 

bounds 

The ovi^rn siz^ *thc view m lo^dl ^oo\rd'ma*tcs. 


The *thc view'm supev-view^s doovd'ma-tcs. 

■tva^s-fovm 

A^y *tva^s-fov-ma*tio^s (v-o-ta-tio^s, -tv-a^slatio^s, d.) applied h> *thc 
view. 

alfha 

The *tv"3^spa\rc^dy o-f view. 


you are here ► 


497 














accelerometer 


Accelerometer 


One of the most versatile pieces of hardware in the iPhone and iPod Touch is the 
accelerometer. The accelerometer allows the device to detect acceleration and the pull of 
gravity along three axes. With just a few lines of code, you can tell whether the device is right- 
side up, upside down, laying flat on a table, etc. You can even detect how quickly the device is 
changing direction. 

All you need is the UIAccelcroweter 


Getting orientation information from your device is straightforward. There’s a shared 
UIAccelerometer instance you can access. Like many other iPhone OS classes, the 
UAccelerometer has a delegate protocol, UIAccelerometerDelegate, that declares a single 
method for receiving acceleration information. The class you want to receive that acceleration 
information should conform to the UIAccelerometerDelegate protocol and implement 
didAccelerate: method: 


一 （ void)accelerometer:(UIAccelerometer accelerometer 
didAccelerate : (UIAcceleration acceleration; 






^ a f'rs a 

To receive acceleration information you simply need to tell the accelerometer about the 

delegate and how frequently to send acceleration information, like this: a 议 ^ 此、。於 


self.accelerometer = [UIAccelerometer sharedAccelerometer] 
self.accelerometer.delegate = self; 
self•accelerometer•updatelnterval = 0.5 f; 


6iti slaved 
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Each UIAcceleration object contains acceleration information along the x, y, and z axes and 
a timestamp that the data was collected. In a simple example, you can update labels with the 
acceleration information, like this: 


- (void)accelerometer:(UIAccelerometer *)accelerometer 
didAccelerate:(UIAcceleration *)acceleration { 

self.xOutput.text = [NSString stringWithFormat :@〃％ 
self.yOutput.text = [NSString stringWithFormat :@〃％ 
self.zOutput.text = [NSString stringWithFormat :@〃％ 


acceleration.x]; 
acceleration.y]; 
acceleration.z]; 
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UnderstaHdmg the device acceleration 

First, the bad news. The simulator doesn’t simulate the accelerometer at all. 
You’ll get no information back, regardless of how much you shake your Mac. 
You’ll need to install the application on a real device to get actual accelerometer 
information back. But once you do... 
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If you’re building a typical view-based application, UIKit hides a lot of the 
need for the accelerometer by letting you know about orientation changes 
and automatically providing undo/redo when the user shakes the phone. The 
accelerometer is most useful for custom-drawn applications like games (steering or 
balance) and utility applications (levels). 
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gaming info 


# 6. A word or two about gaming... 


iPhone games are a huge market and get played a lot, but they are also pretty advanced applications. 
It’s outside of the scope of our book to get into those applications — which can use multitouch 
interactions, Quartz and OpenGL graphics, and peer to peer networking — but here we’ll give you a 
quick pass at the technologies that you can use and where to find more information about them. 


Multitouch 

You probably noticed that we only used one of the possible events 
that can be triggered for a button in our apps, the touch up inside 
event. The iPhone is capable of detecting up to five finger touches 
at a time and can interpret how each of those fingers are interacting 
with the screen with several different types of events. 

In addition to touches, the iPhone can detect swipes and gestures 
that can be configured as well. By defining the length and direction 
of a swipe, you can create lots of different ways to interact with 
your application. 

Pinching is a custom gesture that Apple uses in many of its default 
applications, most notably Safari, to zoom in and out of a view. It 
is just registering for a two-finger touch and keeping track of the 
change in the distance between them: if it increases, zoom out, if it 
decreases, zoom in. 

Using these events means that you can create custom interfaces, 
not just touching buttons, for your user. Working with multitouch 
means that your view needs to be configured to be a multitouch 
view, and then you need code to work with each different type of 
event that you’re interested in leveraging. 
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Working with these events requires working with the responder chain (see the UIResponder class 
reference) and the UI Events class reference. 
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Quartz and Open&L 


Quartz and OpenGL are the two ways to create graphics on the iPhone and they are both big 
enough to be books on their own, but here’s a small sample of what you’d be dealing with. 




Quartz is the simpler of the two, allowing you to draw in two dimensions directly into the view. 
The drawing code uses the Core Graphics Framework and renders directly into the 
view. It follows a painter’s model, which means that the order of commands is important. 
The first thing drawn will be covered up with a subsequent drawing in the same location. 
Quartz can handle shading, color, and interfacing with other image and video types. 

The Quartz 2D Programming Guide in the developer documentation has a lot of 
information to help get you started. 


Open 昏 L 


OpenGL can work in two or three-dimensional graphics and is significantly more complex, 
but that means that you have more flexibility to work with. It is a well-established, cross 
platform library that has been implemented for mobile devices with OpenGL ES, and is used 
through the OpenGL ES Framework. 

You can use it to draw lines, polygons, and objects, and animate them as well. A good place to 
get started is with the OpenGL ES Programming Guide for iPhone OS in the developer 
documentation. 


^ame Kit 


New with the iPhone OS 3, the GameKit framework allows you to use both peer to peer 
networking and voice over bluetooth to facilitate interaction with other devices within game 
play. This functionality does not exist for the first generation iPhone, iPod Touch, or the 
simulator alone. 

Similar to the image picker, there is a GKPeerPickerController that provides a 
standard interface for finding other devices running your application and establishing a 
connection. After that connection is established, you can transmit data or voice between 
devices. 

A good place to get started is with the GameKit Programming Guide to leverage this new 
functionality in your app. 


you are here ► 


501 



ii preparing an app ?9r distribution 


參 

Get ready for the App Store 





You want to get your app in the App Store, right? 

So far, we’ve basically worked with apps in the simulator, which is fine. But to get things 
to the next level, you’ll need to install an app on an actual iPhone or iPod Touch before 
applying to get it in the App Store. And the only way to do that is to register with Apple as 
a developer. Even then, it’s not just a matter of clicking a button in Xcode to get an app 
you wrote on your personal device. To do that, it’s time to talk with Apple. 


this is a new chapter 
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get your development certificate 


Apple has rules 


We’ve talked about the HIG, and how stringent Apple can be through the 
approval process — they’re protecting their platform. Part of that is keeping 
track of what goes on your own iPhone, even when it’s stuff you’ve written 
yourself. 

Here we’re going to give you an overview of how you can get an app onto 
your device, and then, in turn, ready for submission. We can’t get into the 
nitty gritty of the full process — for that you need to be a member of the 
iPhone Development Program and pay the S99 fee. 

Start at the Apple Peveloper Portal 



The Developer Portal, where you first downloaded the SDK, is also your hub for managing all the 
parts of electronic signatures that you’ll need to get an app up and running on your iPhone. 

First get your Pevelopment Certificate 


Getting through the process to go from having your app in Xcode to installing it on an iPhone or 
iPod Touch for testing means that you need a Development Certificate and a Provisioning Profile. 
This certificate is signed by you and Apple to register you as a developer. It creates a public and a 
private key, and the private key is stored on the keychain app on your Mac. Here’s how getting that 


certificate works. 

Revest (CSR) - 


个 

Submi 七七 he CSR *to Apple -fov- approval 


your Mad 


OY\ 









The Certikate is sWd a^d 

•.defies you. y，Codt Will use rt -to tKc 
you build *to mstall oy \ a device- 


Apple approves the 
irc^ucs-t gehevates "the 
Thch i-fc gets 
posted Oh the Po\rtal -fov- 
dovmlodd. 



Afflc Pcvdofcrs Portal 






504 Appendix ii 



















preparing an app for distribution 


The Provisiowiwg Profile pulls it all together 

Now that you have a Development Certificate in place, to complete the process you 
need a Provisioning Profile. That electronic document ties the app (through an iPhone 
application ID), the developer, and the certificate together for installation onto the 
device. 
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stay organized 


Keep track iw the Organizer 


The Organizer is a tool that comes with Xcode that we haven’t been able 
to talk much about, but it is key for keeping all of this electronic paperwork 
straight. In Xcode, go to the Window —^ Organizer menu option. 
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P\ro*file and is u^i^uc to eadh device. 



ttev-c youll be able" 
"to get -to yoi 

P\rovisiohihg Pvo^ilcs. 


You ddv> also -take 
sdvccy>sho*ts 七 hvou# 七 he 

Ov^a^izjcv-. 


\y\ \\trt, you II be able *to do^-fi^uvc youv 
dcvidc (or development The Ov^a^'iz^v- 
y/ill make suve 七 ha 七 you have a valid 
so*f*tv/3V*c vcv*s'ioy> -fov* development 3^d i-f 
Y\oi, you choose oy\c *tha*t v/ovb. 


A few final tips... 


This quick overview gives you an idea of how the process works, but you need I C * 

to get into the Developer Program to learn all the details. Our goal her ewas T0 ^ati0h 

just to help you see the big picture of the process. 


A couple of things to be aware of. First, when you’re developing as part of 
a team, the team admin has to be involved in many of these steps. Second, 
you need to go through this process to install anything on your device, 
regardless of whether you plan to release it to the world or not. 

And finally, what about the app store? Once you’ve joined the Developer 
Program, and the application has been tested, then you can submit it for 
approval. 
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Symbols 

& (ampersand), indicating address reference, 405 
<> (angle brackets), enclosing protocols, 94 
* (asterisk), preceding pointer types, 94 
@ (at-sign) symbol, for NS Strings, 30， 147 
: (colon), in named arguments, 117 
- (minus sign), preceding instance methods, 95, 116 
+ (plus sign), preceding static or class methods, 95, 116 
I ] (square brackets), enclosing message passing, 115 

A 

accelerometer, 17, 498-499 
accessors 

auto-generated, 95, 96, 99-100, 109 
multithread safety and, 98 

action methods 

connecting events to, 24-25 
writing code for, 18-20 

action sheets, 452-455 

aesthetics, importance of, 43. See also iPhone apps, designing 
ampersand (&), indicating address reference, 405 
angle brackets (<>), enclosing protocols, 94 
animations 

flip animations, 434-438, 485 
view animations, 497 

API documentation, 56 


app layout, sketching, 40—43 

for DrinkMixer app example, 135 
for iBountyHunter app example, 306—307, 309—311, 
363, 434, 460 
for iDecide app example, 7 
for InstaTwit app example, 41-43 

App Store, submitting apps to, 2, 199—200, 237, 504-506 

app templates. See templates 

Apple Developer’s Program, registering with, 456, 457, 504 
Application Programming Guide, 44 
application resources, 5, 11 ， 12, 35， 159 
apps. See desktop apps; iPhone apps; mobile apps 
arrays, 64 

of dictionaries, 171—172, 189—192, 194—197 
mutable, 110, 144-145, 147 
of strings, 149-153 

assign property attribute, 98, 100, 129 

asterisk (*), preceding pointer types, 94 

atomic keyword, 98 

at-sign (@) symbol, for NS Strings, 30， 147 
autorelease pool, 101 

B 

bartending app example. See DrinkMixer app example 
Boolean data type, 332 
borders, using buttons as, 368 

bounty hunter app example. See iBountyHunter app 
example 
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brackets (□), enclosing message passing, 115 

breakpoints, 178-181, 187 

buttons 

adding to navigation controller, 209—213 

adding to view, 16 

code for, adding, 18-20 

connecting to code, 24-25, 72—74 

HIG guidelines for, 47 

using as borders, 368 

c 

G language 

compared to Objective-G, 109 
support for, 9 

C++ language, 9 
callstack, 188 

camera, 485. See also photos 
devices supporting, 448-451 
inability to test with Simulator, 17, 457 

categories in Objective-G, 109 

cell tower triangulation, 464. See also Gore Location 

check boxes, 400 

classes, defining in header file, 93-95 
Glasses files, 12 

Cocoa Touch framework, 14, 15, 30, 52—53, 109 

code. See also iPhone apps 
debugging. See debugging 
developing. See Xcode 
testing. See testing apps 

colon (:)，in named arguments，117 
console for debugging, 176 
continue command, 187 
Gontrol-Datasource-Delegate pattern, 59 
controls. See UI controls 


copy property attribute, 98, 129 

Gore Data, 329—332, 338, 352, 375 

adding as project resource, 354-355, 357-359 
attributes, adding, 381-384 
classes, creating from entities, 341-343 
components of, 338 
constants, 337 
custom types, 337 
data storage options for, 329 
data types for, 330—332 
data validation by, 405 
entities, creating, 334-336 
fetching data, 344-352 
filtering data, 407—413, 429 
indexed properties, 337 
loading and storing data, 339—340 
Managed Object Context, 338, 344-345, 352, 361 
375, 404 

Managed Object Model, 333-336, 342—343, 352, 
361, 375 

mapping model, 392 

memory management, 329, 416 

migrating data, 385-389, 391 ， 392, 429 

performance considerations, 415—421，423 

as persistence framework, 340, 375 

persistence types supported, 337 

Persistent Object Store, 338, 354, 391， 429 

Persistent Store Coordinator, 338, 354-355, 361 

saving data, 404, 405 

SQLLite database used with, 337 

transient properties, 337 

versioning data model for, 387, 392 

Core Location, 464—470, 475 
costs 

for Apple Developer’s Program, 457 
of iPhone apps, 2 
usage fees, 4 

GPU, availability of, 4 


508 Index 









the index 


D 

datasource, 58-59, 63—67, 87. See also Gore Data; 
datasource under specific example apps 

Date data type, 332 

debugging, 175-181, 183, 237 
breakpoints for, 178-181, 187 
call stack, viewing, 188 
commands for, 177 
console for, 176 
continue command, 187 

DrinkMixer app example, 175—181, 183, 187—190, 
273-274 

next command, 187 
walking through code, 187 

Decimal data type, 332 

decision app example. See iDecide app example 
delegate, 58-59, 63-64, 68-69, 87 
desktop apps, differences from mobile apps, 3-4 
Detail View, Xcode, 12 
detail views 

for DrinkMixer app example, 155—164, 169, 198, 
215-222 

for iBountyHunter app example, 362—371, 394—402 
434-438, 460-470, 472-477, 479 

developer, registering with Apple as, 456, 457, 504 
Development Certificate, 504 
device orientation, 494—496 
dictionaries, 237 

arrays of, 171—172, 189-192, 194-197 
key names in separate file for, 198 
saving, 286 

valueForKey compared to objectForKey, 198 
disclosure indicators, 200—203 
display. See screen 

Documents directory, 358—359, 361 


DrinkMixer app example 
Add button, 209—213 
Cancel button, 229, 232—233, 235, 279 
datasource 
creating, 147 

users adding data to, 207—226, 265—269 
debugging, 175-181, 183, 187-190, 273-274 
delegate, 147 

detail view, 155-164, 169, 198, 215-222 

disclosure indicators, 200—203 

Edit button, 288, 291, 292, 299 

keyboard for adding data, 227, 240—243, 248-264 

modal view ， 224-226, 230—233 

navigation controller 

adding Add button to, 209—213 
back button in, 138, 173 
creating, 136—137 
for modal view, 230—233 
switching between views, 167—168 
notifications 

for app quitting, 282—284, 286 
for keyboard displaying, 250—264 
plist of dictionaries for detail view data, 171—172, 
189-192, 194—197 

plist of strings for table view data, 149—153 
plists, saving when app quits, 282—284 
project, creating, 136—137 
requirements for, 132-135 
Save button, 229, 232—233, 235 
scroll view for adding data, 242-247, 257-263, 
265-269 
sketch for, 135 

submitting to App Store, 199-200, 205 
switching between views, 165—169 
table view, 140—143, 187 
cell labels for, 147 
code for, customizing, 141—145 
created by navigation template, 137, 139 
disclosure indicators in, 200—203 
notifying of new data, 276, 279 
resorting, 280 
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DrinkMixer app example, continued 
template for, 136—137 
title, adding, 138 
user reviews of, 206 

users adding data, 207—227, 240-250, 257-263, 
265-269 

users editing and deleting data, 288-295, 299 

E 

Editor Pane, Xcode, 12 
@end keyword, 116 

enterprise apps, requirements for, 303. See also 
iBountyHunter app example 

errors. See debugging 

events, 18 

connecting methods to, 24-25 
listing for items in views, 23, 24 

example iPhone apps. See DrinkMixer app example; 
iBountyHunter app; iDecide app example; 
InstaTwit app example 

F 

fees. See costs 

fetching data, 344-352 

File’s Owner, 30, 54 

filtering data, 407-413, 429 

first responder, controls as, 112 ， 114, 115 

flip animations, 434-438, 485 

Frameworks files, 11,12 

free method, 110 

fugitives app example. See iBountyHunter app example 


G 

GameKit, 501 

gaming, 500-501. See also Immersive Apps 

garbage collection, not supported, 99, 110. See also 
memory management 

getter methods. See accessors 

GPS, 17, 464. See also Gore Location 

H 

header (.h) files, 11, 92—95 
compared to protocols, 70 
declaring methods in, 18—20 
including into other header files, 94 

hierarchical information, Productivity Apps used for, 
44—46 

HIG (Human Interface Guide), 44-47, 200—203 



IBAction, 18-20, 25-27. See also action methods 

iBountyHunter app example 

action sheets for image source, 452-455 
captured photo view controller, 435—438 
captured table view ， 310, 312, 320—321 
captured table view controller, 310,313—315 
datasource, 327—332 

adding captured data to, 380—389, 406—413 
adding captured photo to, 439—440 
adding to resources, 354-355, 357-359 
downloading database for, 353 
fetching data from, 344—352 
filtering, 407—413 

Fugitive entity in, 334—336, 341—343 
loading data into, 339—340 
sorting data from, 344—345, 352 
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detail view 

adding capture location to, 460—470 
adding captured fields to, 394—402 
adding location map to, 472—477, 479 
creating, 362—371 
flipping over for photo, 434—438 
directory structure for, 358, 361 
fugitive table view, 310, 312, 317 
fugitive table view controller, 310, 313—315, 316 
icons 

for app, 312 
for tab bar, 321 

image picker controller, 441—446, 451, 457 
info button, 434—437 
installing on iPhone, 456 
main window nib, contents of, 312, 321 
navigation controller, 308, 316 
performance enhancements, 415—421，423 
project, creating, 308 

requirements for, 304—307, 378-380, 432-434, 
458-460 

sketches and diagrams for, 306—307, 309—311 ， 363, 
434, 460 

tab bar controller, 307, 312, 375 
creating, 313—315, 320—321 
embedding in UlWindow, 324 
icons for, 321 

notifications for changing tabs, 321 
number of views in, 321 
template for, 308 

IBOutlet, 19—20, 25-27, 75-79, 94 

icons for applications, 54 

for iBountyHunter app, 312 
size requirements for, 312 

id type, 120 

IDE, Xcode. See Xcode 

iDecide app example 
button, adding, 16 
button code, adding, 18-20 
button label, adding, 16 


connecting code to controls, 23-25 

project, creating, 10 

requirements for, 6 

sketch for, 7 

template for, 10 

view, building, 14—16 

image picker controller, 441—446, 451, 457 
images. See photos 
Immersive Apps, 44—46 

implementation (.m) files. See View Controllers 
(^implementation keyword, 116 
#import keyword, 93—94, 222 
init methods, 110 
input. See user input 

instance methods, minus sign (-) indicating, 95 

InstaTwit app example 

button, adding, 49, 72—74 
datasource, 64—67 
delegate, creating, 64, 68-69 
labels, adding, 49 
picker, adding, 49 
picker data 

adding, 55—57 
extracting, 75—79 
project, creating, 48 
requirements for, 38-40, 90—91 
sketch for, 41—43 

talking to Twitter, 81-82, 124-126 
template for, 48 

text field for custom input, 91—92, 96, 106—107 
111-115, 118-119 
view, building, 48—50 

Instruments, 110 

Int32 data type, 332 

Interface Builder, 14-15, 23-25, 30, 35 

@interface keyword, 94 

interface orientation, 494—496 
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interfaces, defining in header file, 93—95 
internationalization, 488—491 
Internet access, availability of, 4 
iPhone 

differences from iPod Touch, 448—451 
differences from Simulator, 17 
models of, differences between, 9 
testing apps on, 17, 504-506 

iPhone Application Programming Guide, 44 
iPhone apps, 37 

compatibility with other mobile devices, 9 
components of, 5. See also View Controllers; views 
debugging. See debugging 
designing, 44—47, 54 
development considerations for, 9 
directory structure for, 358, 361 
examples of. See DrinkMixer app example; iBoun- 
tyHunter app example; iDecide app example; 
InstaTwit app example 
giving to friends, 9 
icons for, 54 

one running at a time, 4 
purpose of, 3 

quitting, notification for, 282—284, 286 
sketching GUI for. See sketching app layout 
submitting to App Store, 237, 504-506 
templates for. See templates 
testing. See testing apps 
types of, 44—46 

uninstalling, files removed when, 361 
iPhone HIG. See HIG (Human Interface Guide) 
iPod Touch 

differences from iPhone, 448—451 
requirements of App Store for, 457 


K 

keyboard 

covering other fields, 240—243, 248-250 
disappearing when control gives up focus, 115 
displayed for specific controls, 108, 111—114, 227 
notifications sent when displayed, 250-254 
notifications sent when done, 118—119 



labels, 16, 23, 49 

languages, programming, 9 

languages, translating. See internationalization 

layout, sketching. See app layout, sketching 

libraries, in Frameworks, 12 

Library, Interface Builder, 14 

localization, 488—491 

location information, sources of. See Gore Location 

M 

.m (implementation) files. See View Controllers 
Main window, Interface Builder, 14, 23 
MainWindow.xib, 52 
malloc method, 110 

Managed Object Context, 338, 344-345, 352, 361, 
375, 404 

Managed Object Model, 333—336, 342—343, 352, 
361， 375 

Map Kit, 472—477, 479 
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memory 

availability of, 4 

inability to test with Simulator, 17 
memory management, 129 

auto-generated accessors handling, 99—100 
checking usage with Instruments, 110 
for Gore Data, 329, 416 

garbage collection not supported on iPhone, 99， 110 
problems with, reasons for, 110 
for properties, 110 

reference counts for objects, 99 ， 101 ， 102， 109 
releasing objects, when and how to, 101， 110 
for table views, 143 

messages 

compared to methods, 117 
compared to notifications, 252 
list of, in Apple documentation, 115 
objects unable to respond to, 120 
passing between objects, 114—120 
passing to nil, 115 
receiver of, 115, 120 

metadata, 5 

methods. See also accessors; action methods 
compared to messages, 117 
defining in header file, 95, 120 
grafting onto existing classes (categories), 109 
implementing in .m file, 116, 120 
named arguments in, 117, 120 
selectors for, 120 

migrating data, 385-389, 391 ， 392, 429 

minus sign (-), preceding instance methods, 95, 116 

missing reservations mystery, 270, 275 

mobile apps, 3-4, 9 

modal views, 224-226, 237 

multiple inheritance, Objective-G not supporting, 94 
multithread safety, accessors and, 98 


multitouch, 500 

mutable arrays, 110, 144—145, 147 
mutable strings, 110 

N 

Navigation-based Application, 136—137，183 
adding Add button to, 209—213 
back button in, 138, 173 
built-in apps using, 137 
for modal view, 230—233 
switching between multiple views, 167—168 
table view as default root view for, 137, 139 
title for, adding, 138 

next command, 187 

nibs (.xib files), 11 ， 15, 17, 30, 54. See also views 
nonatomic keyword, 98, 99 

notifications, 250-252 

for app quitting, 282—284, 286 

for changing tabs, 321 

compared to messages, 252 

creating, 254 

for keyboard, 250—264 

registering with default notification center, 

251, 255-256, 286 
sent by iPhone, list of, 254 

NS Array class. See arrays 
NS Coding protocol, 173, 286 
NSDate class, 332 
NSDecimalNumber class, 332, 337 
NSDictionary class. See dictionaries 
NSError class, 405 

NSFetchedResultsGontroller class, 416—421 ， 423, 
426, 429 

NSFetchRequest class, 344-345, 352, 408-413, 429 
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NSLog method, 124, 177 
NSManagedObject class, 342—343, 352, 405 
NSMu table Array class ， 144—145, 147 
NSMu table String class, 110 
NSNotificationGenter class. See notifications 
NSNumber class, 332 
NSPredicate class. See predicates 
NSSortDescriptor class, 280, 352 
NS String class. See strings 

0 

Objective-C language, 9, 109, 129 
compared to G language, 109 
multiple inheritance not supported by, 94 

OpenGL ES Application, 501 
Organizer tool, 506 
orientation of device, 494—496 
Other Sources files, 12 

P 

performance 

for Gore Data, 415—421，423 
inability to test with Simulator, 17 

persistence framework, 340, 375 
Persistent Object Store, 338, 354, 391， 429 
Persistent Store Coordinator, 338, 354-355, 361 

photos, 485. See also camera 

action sheets for image source, 452-455 
displaying on flip side of detail view, 434—438 
image picker controller for, 441—446, 451, 457 
in Resources, 11 
storage for, 439-440 


pickers, 56. See also image picker controller 
adding to view, 49 
components in, 56, 70, 87 
data for, adding, 55-57 
datasource for, 58—60, 63—67 
delegate for, 58—60, 63—64, 68—69 
extracting values from, 75—79 
HIG guidelines for, 47 
rows in, 56, 70, 87 

pictures. See photos 
plists, 183 

array of dictionaries, 171—172, 189-192, 194—197 
array of strings, 149 — 153 
saving when app quits, 282—284 

plus sign (+), preceding static or class methods, 95, 116 

pointer types, asterisk ( 氺） indicating, 94 

predicates, 407-413, 426 

@private keyword, 94, 222 

Productivity Apps, 44—46 

programming languages for iPhone, 9 

projects, 10—11 

creating, 10, 48, 136-137, 308 
templates for. See templates 

properties 

defining in header file, 95 

naming differently than field name, 98 

retaining and releasing automatically, 110 

property attributes, 96—98, 129 

@property keyword, 95, 96 

property lists. See plists 

protocols, 63-66, 70, 87, 94 

Provisioning Profile, 504—505 

@public keyword, 94, 222 
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selectors, 120 

setter methods. See accessors 


Quartz, 501 

R 


read and write permissions for data, 358 
readonly property attribute, 98, 129 
re ad write property attribute, 96, 98, 129 
reference counting, 99, 101 ， 102, 109 
references, listing for items in views, 23, 24 
release method?, 99, 101, 106, 110 
reloadData message, 276 
reservations mystery, 270, 275 
resources, caching of, 491 
Resources files, 5, 11, 12, 35, 159 
retain count. See reference counting 
retain method?, 99, 110 
retain property attribute, 98, 99, 129 
root view, 11, 52—53 
rotation of view, 494—496 



screen 

capabilities of, 4 
resolution of, 7 
rotation of, 494—496 

scroll views, 242-247, 257-263, 265-269 

SDK, 8. See also Instruments; Interface Builder; Simulator; 
Xcode 

segmented controls, 396, 398-402 


Settings page, 43 
Simulator, 30 

app crashing on real iPhone but not in Simulator, 110 
differences from real iPhone, 17 
limitations of, 17, 457 
testing apps in, 13, 16—17 

sketching app layout, 40—43 

for DrinkMixer app example, 135 
for iBountyHunter app example, 306—307, 309—311 ， 
363, 434, 460 
for iDecide app example, 7 
for InstaTwit app example, 41-43 

SQLLite database, 337 

square brackets (□), enclosing message passing, 115 

stack, debugger. See call stack 

static methods, plus sign (+) indicating, 95 

status bar, 7 

String data type, 332 

strings, 30, 124-126, 332 
arrays of, 149-153 
localizing, 490—491 
mutable, 110 

switches, 400 

@synthesize keyword, 77, 96, 98 

T 

tab bar controller, 307, 312, 375 
creating, 313-315, 320—321 
embedding in UlWindow, 324 
icons for, 321 

notifications for changing tabs, 321 
number of views in, 321 
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table views 

for DrinkMixer app example, 140—143, 183 
cell labels for, 147 
code for, customizing, 141—145 
created by Navigation-based Application, 137, 139 
deleting rows, 288-295, 299 
deleting rows, not allowing, 299 
disclosure indicators in, 200—203 
editing rows, 288-295, 299 
grouped table views, 147 
memory management for, 143 
moving rows in, 299 
reloading after data added, 276, 279 
resorting, 280 

section headers and footers for, 147 
for iBountyHunter app example 

captured table view, 310, 312, 320—321 
captured table view controller, 310,313—315 
fugitive table view, 310, 312, 317 
fugitive table view controller, 310, 313—315, 316 
resorting, 280 

templates, 10—11 

for DrinkMixer app example, 136—137 
files in, 11 ， 12. See also Resources files 
for iBountyHunter app example, 308 
for iDecide app example, 10 
for InstaTwit app example, 48 

Navigation-based Application. See Navigation-based 
Application 

OpenGL ES Application, 501 
View-based Application, 10, 48 
Window-based Application, 308 

testing apps 

on iPhone, 17, 504—506 

in Simulator, 13, 16-17. See also debugging 

text fields 

for custom input in InstaTwit, 92, 96, 106—107 
customizing, 113 
events for, 119 

keyboard displayed for. See keyboard 
placeholder text for, 159 
un-editable, specifying, 164 


text strings. See strings 
thread safety, 98 
TouchUpInside event, 24-25 
translations. See localization 

troubleshooting. See also debugging 

app crashing on real iPhone but not in Simulator, 110 
messages passed to nil, 115 

translations not working because of cached resources, 
491 

Twitter, talking to from iPhone app, 40, 81-82, 124—126 
Twitter app example. See InstaTwit app example 

TJ 

UI controls. See also specific controls 
events triggered by. See events 
as first responder, 112 ， 114， 115 
having focus, 112, 114 

UIAccelerometer, 498—499 
UIApplicationMain, 52 
Ullmage class. See photos 

UINavigationGontroller class. See Navigation-based 
Application 

UlPickerView class. See pickers 
UlScrollView class. See scroll views 
UITableViewGontroller class. See table views 
UITextField class. See text fields 
UlWebView, 492-493 
usability, 43. See also iPhone apps, designing 
usage fees, 4 

user input, 4. See also keyboard 

adding data, 207—227, 240-250, 257-263, 265-269 
editing and deleting data, 288-295, 299 

Utility Apps, 44—46 
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variables. See also IBOutlet 
versioning data model, 387, 392 
video, image picker controller for, 457 
view animations, 497 

View Controllers (.m files), 5 
adding code to, 18-20 
adding to reuse existing view, 215-222 
as File^ Owner, 30 

view rotation, 494—496 

View-based Application, 10, 48 

viewDidLoad method, 415—416 

views, 5, 35, 237. See also detail views; table views 
building, 14-16, 48-50 
hierarchical view of, 23 
in Interface Builder, 14 

items in, listing events and references for, 23, 24 
modal views, 224-226, 230—233, 237 
nibs (.xib files) for, 11, 15, 17, 30, 54 
reusing with new View Controller, 215—222 
root view, 11, 52-53 

scroll views, 242—247, 257-263, 265-269 
sketching. See sketching app layout 
subclassing, 219—220, 222 
switching between multiple views, 165—169 
when not to reuse, 218 

viewWillAppear method, 416, 418, 426 


¥ 

warnings, 175 
Web Kit, 492-493 
website resources 

fugitive list for iBountyHunter app, 353 
iPhone HIG, 44 
iPhone SDK, 8 
Twitter, 81 

Wi-Fi Positioning Service, 464. See also Gore Location 
Window-based Application, 308 
write permissions for data, 358 

X 

Xcode, 12— 13, 30, 35 

API documentation, accessing, 56 
benefits of, 9 
editors in, 13 

features in 3.2 but not in 3.1，314 
Organizer tool, 506 
preparing apps for sale with, 13 
templates in. See templates 

.xib files (nibs). See views 

XML, nibs as, 15 
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